Claude Code 스킬은 ~/.claude/skills/에 저장되는 재사용 가능한 지침 팩(instruction packs)입니다. 명확한 설명(description) 필드가 포함된 SKILL.md 파일을 작성하여 세션 전반에 걸쳐 컨벤션(conventions), 테스트 규칙 또는 도메인 지식(domain knowledge)을 자동으로 트리거하세요.

핵심 요약 (Key Takeaways)

• Claude Code 스킬은 ~/.claude/skills/에 저장되는 재사용 가능한 지침 팩(instruction packs)입니다.
• 명확한 설명(description) 필드가 포함된 SKILL.md 파일을 작성하여 세션 전반에 걸쳐 컨벤션(conventions), 테스트 규칙 또는 도메인 지식(domain knowledge)을 자동으로 트리거하세요.

변경된 점 — 스킬은 이제 당신이 가장 활용하지 않는 Claude Code 기능입니다

만약 당신이 매번 Claude Code 세션마다 동일한 지침을 붙여넣고 있다면—예를 들어 "Vitest로 테스트를 작성하고, 통합 테스트를 선호하며, 데이터베이스용 모의 객체(mocks)는 사용하지 마세요"와 같은 내용 말입니다—당신은 시간을 낭비하고 있는 것입니다. Claude Code 스킬을 사용하면 이러한 지침들을 관련 상황에서 자동으로 로드되는 재사용 가능한 팩으로 패키징할 수 있습니다.

스킬은 SKILL.md 파일이 들어 있는 폴더일 뿐입니다. 그게 전부입니다. 설정도 필요 없고, 실행할 서버도 필요 없습니다. 모델에게 언제 사용할지를 알려주는 프론트매터(frontmatter)가 포함된 마크다운(markdown) 파일 하나면 충분합니다.

당신에게 주는 의미 — 반복을 멈추세요

스킬은 매 세션마다 Claude Code에게 당신의 컨벤션(conventions)을 수동으로 상기시키던 습관을 대체합니다. 스킬은 문맥 인식(context-aware)이 가능합니다. 모델은 계획(planning) 단계에서 스킬의 설명을 읽고, 작업이 일치할 때만 이를 로드합니다. 이는 매 세션마다 실행되는 시스템 프롬프트(system prompt)와는 다릅니다. 스킬은 라이브러리에 더 가깝습니다. 에이전트가 스킬 선반을 가지고 있다가, 필요할 때 필요한 것을 꺼내 쓰는 방식입니다.

스킬이 즉각적인 효과를 발휘하는 세 가지 패턴은 다음과 같습니다:

1. 세션 간 반복되는 워크플로우 (Repeatable workflows): 테스트 작성 컨벤션(conventions), 배포 스크립트, 코드 리뷰 체크리스트.
2. 프로젝트 특정 컨벤션 (Project-specific conventions): 명명 규칙(naming rules), 파일 구조, 에러 핸들링 패턴.
3. 도메인 전문 지식 (Domain expertise): 내부 API 사용법, 프레임워크 특정 패턴, 레거시 코드베이스의 특이사항.

지금 바로 시도해보세요 — 30초 만에 첫 번째 스킬 작성하기

다음 파일을 생성하세요:

~/.claude/skills/test-writer/SKILL.md

다음 내용을 포함하여:

---
name: test-writer
description: "|"
...

프론트매터 (frontmatter)의 description이 트리거 (trigger) 역할을 합니다. 모델은 세션 계획 (session planning) 중에 이를 읽습니다. 작업에 테스트가 포함되어 있으면 해당 스킬을 로드하고, 그렇지 않으면 보관함에 그대로 둡니다.

스킬 (Skill) vs MCP 서버 (MCP Server) vs 서브에이전트 (Subagent) — 언제 무엇을 사용할 것인가

하나의 워크플로 (workflow)에서 이 세 가지를 모두 함께 사용할 수 있습니다. 에이전트는 Bash 도구, MCP로부터 받은 GitHub 도구, "설명을 포함한 PR 생성" 스킬을 갖게 되며, 코드 리뷰는 code-reviewer 서브에이전트 (subagent)에게 위임합니다. 각 계층은 자신이 잘하는 역할을 수행합니다.

알아두면 유용한 번들 스킬 (Bundled Skills)

Claude Code에는 지금 바로 사용할 수 있는 여러 번들 스킬이 포함되어 있습니다:

• /batch: 여러 git 워크트리 (worktrees)에 걸쳐 병렬 작업을 생성합니다. 작업 목록을 전달하면 이를 병렬로 실행합니다.
• /simplify: 복잡한 프롬프트 (prompt)나 작업을 더 명확한 실행 계획으로 재구성합니다.
• /debug: 문제 해결 루프 (troubleshooting loops), 재현 (reproductions), 그리고 근본 원인 (root cause)을 좁히는 데 집중합니다.
• /loop: 세션이 열려 있는 동안 프롬프트를 반복해서 실행합니다. 가벼운 모니터링에 유용합니다.
• /claude-api: 작업이 특히 Anthropic의 API 인터페이스에 관한 것일 때 유용합니다.

스킬 설명 (Skill Descriptions) 튜닝하기

description 필드가 가장 중요한 부분입니다. 효과적인 패턴은 다음과 같습니다:

• 사용 조건을 먼저 제시하세요. "[X]일 때 이 스킬을 사용하세요." 모델은 이를 분류 규칙 (triage rule)으로 파싱합니다.
• 결과물이나 출력물 (artifact or output)의 이름을 명시하세요. "테스트 작업을 위해"보다는 "테스트를 생성할 때"가 더 유용합니다.
• 범위 (scope)를 명확히 하세요. "Vitest 및 Playwright 테스트만"이라고 명시하면 관련 없는 테스트 대화에서 스킬이 트리거되는 것을 방지할 수 있습니다.

실패하는 패턴:

• 모호한 설명. "개발을 도와줌"과 같은 표현은 모든 상황에 해당합니다. 모델이 이를 끊임없이 트리거하여 컨텍스트 (Context)를 오염시킵니다.
• 사용 조건 대신 기능을 나열함. "테스트 작성, 린터 (Linter) 실행, 코드 포맷팅 방법을 알고 있음"은 해당 스킬이 무엇을 아는지 설명할 뿐, 언제 사용해야 하는지를 설명하지 않습니다.

프로젝트 범위 (Project-Scope) vs 사용자 범위 (User-Scope) 스킬

• 사용자 범위 (User scope) (~/.claude/skills/): 여러 프로젝트에 걸쳐 유지되는 개인적인 선호도 및 컨벤션 (Conventions).
• 프로젝트 범위 (Project scope) (.claude/skills/ in your repo): 명명 규칙 (Naming conventions), 프레임워크 선택, 새 파일이 저장될 위치와 같이 프로젝트에 특화된 규칙.

프로젝트 범위의 스킬은 리포지토리 (Repo)에 커밋하여 모든 팀원이 자동으로 적용받을 수 있도록 하세요.

출처: dev.to

원문 게시지: gentic.news