Agent Skill: 프롬프트와 컨텍스트 다음의 설계 단위

TL;DR. 스킬은 프롬프트·컨텍스트 다음의 설계 단위다. 정의 → LLM이 적용하는 원리 → Claude의 로드 단계와 우선순위 순서로 정리한다. 핵심은 AGENTS.md가 SKILL.md보다 먼저 읽히고 더 높은 우선순위를 가진다는 점.

스킬은 무엇이고 LLM이 어떻게 적용하는가

정의

스킬(Agent Skill)은 재사용 가능한 절차·자원·정책·결정론 코드의 묶음을 한 단위로 패키징한 것이다. 가장 일반적인 형태는 디렉토리 + 그 안의 SKILL.md 마크다운 파일이며, frontmatter에 메타데이터(이름·설명·트리거 조건)가, 본문에 실제 절차가 들어간다.

프롬프트·컨텍스트와 다른 점은 단위의 영속성과 합성 가능성에서 온다.

단위	휘발성	합성
프롬프트	1회용 메시지	불가
컨텍스트	세션 한정	부분적
스킬	파일로 영속	다른 스킬 호출·버전 관리 가능

즉 스킬은 소프트웨어 모듈에 가깝다. import할 수 있고, 의존성을 가지며, 쓸수록 자산이 쌓인다.

LLM이 스킬을 적용하는 원리

핵심은 메타데이터와 본문의 분리다.

메타데이터(이름·설명·트리거)는 세션 시작 시 컨텍스트에 로드된다. 모델은 "어떤 스킬이 존재하는가"를 항상 안다.
본문(실제 절차)은 호출 시점에만 lazy load된다. 컨텍스트 윈도 비용을 줄이기 위함이다.

호출 트리거는 두 갈래다.

명시적 호출 — 사용자가 /skill-name 같은 슬래시 명령으로 직접 부른다.
자가 호출 — 모델이 사용자 요청을 받고 description과 매칭해 스스로 호출한다 (Skill 같은 메타 툴 사용).

호출되면 본문이 컨텍스트에 들어와서 모델이 그 절차를 따른다. 본문이 아직 비어 있을 때에도 그 스킬이 존재한다는 사실은 모델이 알고 있기 때문에, 사용자의 의도를 적합 스킬에 매칭하는 판단 자체에 사용된다.

Claude의 로드 단계와 우선순위

Claude Code의 경우 다음 순서로 스킬·컨텍스트가 로드된다.

SessionStart 훅 — 세션 시작 시 항상 로드되는 컨텍스트 (사용자가 hook으로 거는 컨텍스트 매니페스트·활성 작업 노트 등)
CLAUDE.md — 프로젝트 루트 + 글로벌(~/.claude/CLAUDE.md)
AGENTS.md — 프로젝트 정책 파일. 있으면 자동 로드
사용 가능 스킬 목록 — 이름·설명만 메타데이터로 로드 (본문은 아직)
특정 스킬 본문 — 호출 시점에 Skill 툴 또는 /command로 lazy load

충돌이 났을 때 적용되는 우선순위는 다음과 같다.

사용자 명시 지시 (CLAUDE.md, AGENTS.md, 대화 중 직접 요청) — 최우선
스킬 본문의 규칙 — 기본 동작 오버라이드
기본 시스템 프롬프트 — 최하위

이 순서가 운영의 핵심이다 — AGENTS.md가 SKILL.md보다 먼저 읽히고 더 높은 우선순위를 가진다. 자작 스킬과 외부 큐레이션 스킬셋이 부딪히는 상황에서 결정자는 결국 사용자가 쓴 AGENTS.md·CLAUDE.md다. 뒤에 다룰 충돌 패턴 7가지에서 이 정책 파일이 최후의 가드레일로 반복 등장한다.

현재 자리 잡은 스킬·도구 카테고리

운영 시 자주 마주치는 스킬·도구를 용도별로 한 번씩 훑는다. 자세한 상황별 활용·충돌은 하위 문서에서 다룬다. 카탈로그는 매주 늘어나니 이 섹션은 완전한 목록이 아니라 유형 지도로 읽기.

공식·반공식 표준

.claude/skills 디렉토리 패턴 — Anthropic의 사실상 표준. SKILL.md를 디렉토리 안에 두고 description으로 발견되는 구조.
Codex Plugins and Skills — OpenAI Codex 트랙. 어휘는 다르지만 의도는 같다.
Claude Code Routines — 절차 위주의 다른 표현.

개인 큐레이션 스킬셋

forrestchang/andrej-karpathy-skills — Karpathy의 LLM 코딩 함정 메모를 CLAUDE.md로 정리.
mattpocock/skills — .claude/skills 디렉토리 공개 케이스.
obra/superpowers — 메타스킬 프레임워크.
addyosmani/agent-skills — 코딩 에이전트용 프로덕션급 엔지니어링 스킬셋.
ComposioHQ/awesome-codex-skills — Codex CLI/API 어웨섬 리스트.

도메인 특화

browserbase/skills — 웹 브라우징.
anthropics/financial-services — 금융.

메모리·컨텍스트 부속

스킬은 아니지만 함께 운영해야 살아남는 부속들.

thedotmack/claude-mem — 세션 압축·재주입.
mksglu/context-mode — 컨텍스트 토큰 절감.
rohitg00/agentmemory — 영속 메모리.

학술 트랙

당장 손에 잡히는 도구는 아니지만, 평가·자가진화·RL 통합 미들웨어가 향후 이 자리에서 나올 것:

스킬 표현의 구조화 (From Skill Text to Skill Structure)
스킬 자가진화 (Skills-Coach, SkillOS)
스킬-RL 통합 (Skill1, HeavySkill)
도메인 감사 (MedSkillAudit)

이 트랙은 한 달 새 형식 → 저자 → 거주지가 차례로 사람 손을 떠나는 궤적으로 굳었다 — 본문은 손으로 쓰는 스킬의 끝 — SKILL.md에서 자가진화·잠재 스킬로에서 다룬다.

MCP·도구 프록시

스킬은 아니지만 함께 운영. 스킬이 절차를, MCP가 도구를 채워주는 구도다.

ChromeDevTools/chrome-devtools-mcp — 브라우저 자동화.
일반 MCP 서버 — 도구 채널.

종합

스킬은 메커니즘 위에 운영이 얹혀야 작동한다. 정의·LLM 적용 원리·로드 우선순위까지가 메커니즘이고, 그 위에서 어떤 상황에 무엇을 쓰고 어떤 조합이 깨지는지는 운영 영역이다.

카탈로그는 매주 늘어난다. 하지만 매칭 패턴과 충돌 패턴은 추상화 레벨이 높아 잘 안 흔들린다. 카탈로그는 따로 갱신하면 되고, 운영 패턴은 반복 검증하며 다듬어가면 된다.