Communitygithub.com

SamuelChien/mega-skills-collection

프로젝트 계층 구조에서 `AGENTS.md` 파일을 자동으로 감지하고 로드하여 AI 코딩 에이전트에게 운영 컨텍스트를 제공합니다.

mega-skills-collection란 무엇인가요?

이 스킬은 AI 코딩 에이전트를 위해 현재 작업 디렉토리와 상위 디렉토리에서 `AGENTS.md` 파일을 자동으로 검색하고 로드하여 통합된 컨텍스트를 제공합니다. 모노레포, 중첩된 작업 공간 등 다양한 프로젝트 구조에서 전역 규칙과 하위 프로젝트별 지침을 계층적으로 병합하여 충돌을 감지하고 보고합니다. Claude Code, Cursor, Codex 등 AI 코딩 에이전트를 지원하며, 파일 시스템 스캔 권한과 Grep 접근 권한이 필요합니다. 이 스킬은 세션 중 중복 스캔을 방지하기 위해 결과를 캐싱하고, 순환 심볼릭 링크, 권한 오류, 파일 인코딩 문제 등을 처리하며, 발견된 파일이 없을 경우 템플릿 생성을 제안합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/SamuelChien/mega-skills-collection/tree/HEAD/agent-context-loader

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Agent Context Loader

개요

프로젝트 계층 구조 전반에서 AGENTS.md 파일을 자동으로 검색하고 로드하여 AI 코딩 에이전트에 제공합니다. 이 스킬은 현재 작업 공간과 상위 디렉토리를 스캔하여 에이전트 명령 파일을 찾은 다음, 그 내용을 표면화하여 활성 에이전트 세션이 전체 운영 컨텍스트를 가질 수 있도록 합니다.

전제 조건

  • 모든 디렉토리 깊이에 하나 이상의 AGENTS.md 파일이 포함된 프로젝트 작업 공간
  • 디렉토리 트리를 탐색할 수 있는 읽기 및 Glob 권한
  • 여러 후보 파일이 있을 때 파일 내용을 검색하기 위한 Grep 액세스 권한

지침

  1. 현재 작업 디렉토리와 모든 상위 디렉토리(파일 시스템 루트 또는 저장소 루트까지)에서 AGENTS.md 또는 agents.md라는 파일을 스캔합니다.
  2. 현재 작업 공간의 하위 디렉토리에서 서브 프로젝트 또는 모듈에 적용될 수 있는 추가 AGENTS.md 파일을 검색합니다.
  3. 로드 순서를 결정합니다. 저장소 루트에 가까운 파일이 먼저 로드되고(전역 컨텍스트), 더 깊은 디렉토리의 파일이 나중에 로드됩니다(재정의 또는 보충).
  4. 발견된 각 AGENTS.md 파일을 읽고 명령 블록, 워크플로우 정의 및 제약 조건 선언을 추출합니다.
  5. 명령을 통합 컨텍스트로 병합하고, 수준 간 충돌(예: 하위 디렉토리 에이전트가 루트 수준 규칙을 재정의)을 기록합니다.
  6. 로드된 컨텍스트를 구조화된 요약(소스 파일 경로, 명령 수, 감지된 충돌)으로 제시합니다.
  7. 후속 활성화에서 불필요한 파일 시스템 스캔을 방지하기 위해 현재 세션의 검색 결과를 캐싱합니다.

출력

  • 디렉토리 깊이와 함께 발견된 AGENTS.md 파일 경로의 정렬된 목록
  • 모든 발견된 에이전트 컨텍스트를 결합한 병합된 명령 집합
  • 수준 간 모순되는 지시 사항을 강조하는 충돌 보고서
  • 결과가 새 것인지 재사용된 것인지 나타내는 세션 캐시 상태

오류 처리

오류원인해결 방법
AGENTS.md 없음작업 공간에 에이전트 명령 파일이 없음올바른 작업 디렉토리 확인; 프로젝트 루트에 AGENTS.md 생성 필요
디렉토리 탐색 권한 거부됨작업 공간 위의 제한된 상위 디렉토리스캔 깊이를 저장소 루트( .git/ 존재로 감지)로 제한
순환 심볼릭 링크 감지됨심볼릭 링크된 디렉토리가 무한 탐색 루프 생성스캔 중 심볼릭 링크된 디렉토리 건너뛰기; 심볼릭 링크 경로와 함께 경고 기록
수준 간 명령 충돌하위 디렉토리 AGENTS.md가 루트 수준 파일과 모순됨출력에서 충돌 표시; 기본적으로 더 구체적인(더 깊은) 명령 적용
파일 인코딩 오류AGENTS.md가 UTF-8이 아닌 인코딩 사용latin-1 대체 시도; 파일 경로 및 인코딩 문제 보고

예시

예시 1: 패키지별 에이전트 지침이 있는 모노레포

  • 구조: 루트 AGENTS.md는 전역 규칙을 설정하고, packages/api/AGENTS.md는 API별 도구 규칙을 추가합니다.
  • 결과: 두 파일이 순서대로 로드됩니다. API별 규칙은 충돌 없이 전역 컨텍스트를 보완합니다.

예시 2: 충돌하는 커밋 정책이 있는 중첩 작업 공간

  • 구조: 루트 AGENTS.md는 "항상 커밋 서명"을 지시하고, services/legacy/AGENTS.md는 "커밋 서명 건너뛰기"를 지시합니다.
  • 결과: 충돌이 감지되고 보고됩니다. 더 깊은(레거시) 지시 사항이 적용되며 재정의에 대한 경고가 표시됩니다.

예시 3: 에이전트 파일이 없는 첫 설정

  • 구조: AGENTS.md가 전혀 없는 갓 클론된 저장소.
  • 결과: 스캔 완료 시 파일이 0개 발견됨. 출력에는 저장소 루트에 최소 템플릿으로 AGENTS.md를 생성하라는 제안이 포함됩니다.

리소스

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

SamuelChien/mega-skills-collection

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

SamuelChien/mega-skills-collection

Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español.

SamuelChien/mega-skills-collection

Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante.

SamuelChien/mega-skills-collection

Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho específico de un proyecto para inyectar conocimientos, regulaciones y estándares únicos del sector. Actívalo tras definir el nicho.

SamuelChien/mega-skills-collection

2D game development principles. Sprites, tilemaps, physics, camera.

SamuelChien/mega-skills-collection

3D game development principles. Rendering, shaders, physics, cameras.

SamuelChien/mega-skills-collection

Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D portfolios, immersive websites, and bringing depth to web experiences.

SamuelChien/mega-skills-collection

Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases. Use when auditing accessibility, fixing a11y violations, checking color contrast, generating compliance reports, or integrating accessibility checks into CI/CD pipelines.

SamuelChien/mega-skills-collection

Ab Test Analyzer - Auto-activating skill for Data Analytics. Triggers on: ab test analyzer, ab test analyzer Part of the Data Analytics skill category.

SamuelChien/mega-skills-collection

A B Test Config Creator - Auto-activating skill for ML Deployment. Triggers on: a b test config creator, a b test config creator Part of the ML Deployment skill category.

SamuelChien/mega-skills-collection

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "conversion experiment," "statistical significance," or "test this." For tracking implementation, see analytics-tracking.

SamuelChien/mega-skills-collection

Acceptance Criteria Creator - Auto-activating skill for Enterprise Workflows. Triggers on: acceptance criteria creator, acceptance criteria creator Part of the Enterprise Workflows skill category.

SamuelChien/mega-skills-collection

Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and acceptance verification with minimal human re-intervention.

SamuelChien/mega-skills-collection

Accessibility Audit Runner - Auto-activating skill for Frontend Development. Triggers on: accessibility audit runner, accessibility audit runner Part of the Frontend Development skill category.

SamuelChien/mega-skills-collection

You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance.

SamuelChien/mega-skills-collection

Web accessibility patterns for WCAG 2.2 compliance including ARIA, keyboard navigation, screen readers, and testing

SamuelChien/mega-skills-collection

Manage Discord channel access — approve pairings, edit allowlists, set DM/group policy. Use when the user asks to pair, approve someone, check who's allowed, or change policy for the Discord channel.

SamuelChien/mega-skills-collection

Create unified specification packages across Business, Development, and Design teams. Staged elaboration (L0 Vision → L1 Requirements → L2 Team Detail → L3 Acceptance Criteria) to build shared understanding. Does not write code.

SamuelChien/mega-skills-collection

Research a company or person and get actionable sales intel. Works standalone with web search, supercharged when you connect enrichment tools or your CRM. Trigger with "research [company]", "look up [person]", "intel on [prospect]", "who is [name] at [company]", or "tell me about [company]".

SamuelChien/mega-skills-collection

Validate messaging consistency across website, GitHub repos, and local documentation generating read-only discrepancy reports. Use when checking content alignment or finding mixed messaging. Trigger with phrases like "check consistency", "validate documentation", or "audit messaging".

관련 스킬