Agent-Skills-for-Context-Engineering
무엇인가
이 저장소는 프로덕션급 AI 에이전트 시스템을 구축할 때 컨텍스트 엔지니어링과 하네스 엔지니어링 원칙을 적용하도록 돕는 스킬 모음이다. 컨텍스트 창의 제약을 단순 토큰 용량이 아니라 주의 메커니즘으로 보고, 컨텍스트가 길어질 때 나타나는 중간 정보 손실, U자형 주의 곡선, 주의력 희소성을 다룬다. 기초·아키텍처·운영·개발 방법론·인지 아키텍처 범주의 스킬로 나뉜다.
어떻게 동작하나
각 스킬은 저장소 루트의 skills/ 아래에 디렉터리로 배치되며, 각 디렉터리에 SKILL.md가 들어간다. 시작 시 에이전트는 스킬 이름과 설명만 로드하고, 작업 맥락에 해당 스킬이 활성화될 때 전체 내용을 읽는 점진적 공개 구조를 쓴다. Claude Code에서는 플러그인 마켓플레이스가 스킬을 자동 발견·활성화하고, Cursor·Codex·GitHub Copilot CLI·Open Plugins 호스트는 .plugin/plugin.json 매니페스트와 skills/ 디렉터리를 통해 스킬을 발견한다. 예제는 특정 의존성 설치 없이 동작하는 Python 의사코드로 제공된다.
무엇과 다른가
프롬프트 엔지니어링이 지시문 문장을 다듬는 작업이라면, 이 스킬 묶음은 모델의 제한된 주의 예산에 들어가는 모든 정보를 큐레이션하는 절차를 규율한다. 단일 CLAUDE.md나 AGENTS.md에 규칙을 평면적으로 나열하는 방식과 달리, 스킬별 디렉터리와 references/ 상대 경로를 유지하고, 호스트가 필요할 때만 해당 스킬을 로드하게 한다. 벤더별 구현보다 Claude Code·Cursor 등 여러 플랫폼에 이식 가능한 원칙을 전면에 둔다.
어떻게 쓰나
Claude Code에서는 /plugin marketplace add muratcankoylan/Agent-Skills-for-Context-Engineering로 마켓플레이스를 등록한 뒤 /plugin install context-engineering@context-engineering-marketplace로 설치한다. Cursor는 플러그인 디렉터리에서 설치하거나 저장소를 복제해 플러그인 루트를 지정하고, 프로젝트 로컬 설치는 스킬 디렉터리를 .cursor/skills/로 복사한다. Codex·GitHub Copilot CLI·기타 Open Plugins 호스트는 .codex/skills/ 또는 .agents/skills/에 스킬 디렉터리를 복사한다. 개별 스킬만 쓰려면 예를 들어 cp -R skills/context-fundamentals .cursor/skills/처럼 디렉터리째 복사하며, SKILL.md를 단일 파일로 평탄화하지 않는다.
전제와 한계
Claude Code, Cursor, Codex, GitHub Copilot CLI, Open Plugins 호스트에서 동작하도록 설계됐지만, Agent Skills 디렉터리 레이아웃과 SKILL.md 규약을 지원하는 호스트가 전제다. README에 공개된 사용 가능 스킬은 context-fundamentals이며, 기초·아키텍처·운영·개발 방법론·인지 아키텍처 범주가 제시되지만 개별 스킬 이름 전체는 확인되지 않는다. 스크립트는 Python 의사코드 수준이라 실제 실행 환경이나 패키지 설치를 보장하지 않는다.
유사 스킬
- skills-constitution에이전트가 능력을 쓰기 전에 조회·매칭·검색을 거치도록 강제하는 메타 규칙 팩이다. 헌법 조항과 훅 스크립트로 미준수 출력을 차단한다.
- navigatorClaude Code에 컨텍스트 엔지니어링 절차를 주입해 문서를 지연 로드하고, 프로필·진단·루프 모드·지식 그래프 스킬로 세션을 작업 완료까지 유지시키는 플러그인이다.
- planning-with-files작업 계획·조사·진행을 task_plan.md·findings.md·progress.md로 디스크에 두고 매 턴 훅으로 재주입해 컨텍스트 초기화 후에도 계획을 복구시키는 플러그인이다.