<div align="center">
Claude Skills
Claude 및 기타 AI 코딩 에이전트를 위한 137개의 생산 등급 스킬을 엄선한 라이브러리입니다.
모든 스킬은 하나의 구조를 따르고, 하나의 목소리로 말하며, 에이전트가 수행하는 작업을 변화시킴으로써 그 자리를 얻습니다.
Catalog · Installation · Writing a skill · Contributing
</div>
이것이 무엇인가요 (What this is)
스킬은 에이전트가 관련성이 있다고 판단할 때 로드하는 Markdown 파일입니다. 이는 에이전트가 작업을 처리하는 방식을 변화시키는 간결한 브리핑 자료 역할을 합니다. 이 저장소에는 엔지니어링, 인프라스트럭처, AI, 문서, 디자인, 작문, 금융 분야에 걸쳐 137개의 스킬이 포함되어 있습니다.
스킬은 프롬프트가 아니며, 문서화(documentation)도 아닙니다. 스킬은 그 설명(description)을 기반으로 자동으로 로드되며, 출력을 변화시키기에 충분히 구체적이어야 합니다. 그렇지 않다면 여기에 속하지 않습니다.
skills/backend/api-design/SKILL.md →
**실수는 내용에 있다.** 이러한 스킬들 대부분에서 가장 가치 있는 문장은 사람들이 무엇을 잘못하는지 구체적으로 명시하는 부분이다. 시스템 프롬프트 상단에 배치되어 프롬프트 캐싱을 조용히 비활성화하는 타임스탬프, 합계를 두 배로 만드는 데이터로 읽힌 전체 행(total row), 또는 전체 E2E 스위트를 불안정하게 만드는 `waitForTimeout` 등이 그것이다.
**저자 한 명, 목소리 하나.** 일관된 구조, 일관된 용어, 일관된 톤. 열두 개의 출처에서 조립된 것처럼 보이는 라이브러리는 아무도 신뢰하지 않는다.
## Repository 구조
.
├── README.md
├── CONTRIBUTING.md
...
## 설치(Installation)
**플러그인으로 Claude Code 사용하기** — 권장됨. 각 카테고리는 하나의 플러그인이므로, 작업하는 두세 개의 플러그인만 설치하면 된다:
/plugin install backend --marketplace nimadorostkar/Claude-Skills-collection
/plugin install data --marketplace nimadorostkar/Claude-Skills-collection
137개의 스킬 설명을 로드하는 것은 매 세션마다 컨텍스트를 소모하므로,
> 우리의 RAG 시스템이 환각(hallucinating)을 일으킵니다
→ rag, llm-evaluation 로드
> 이 PR을 검토해주세요
→ code-review를 로드하고 diff에 대한 언어 스킬도 로드합니다
...
메커니즘은 각 스킬의 프론트매터(frontmatter)에 있는 `description` 필드입니다. 이 설명은 사용자가 실제로 사용할 법한 단어, 즉 "페이지가 느리고 데이터베이스 때문이야"와 같이 작성되어 있으며, "데이터베이스 성능 최적화" 같은 전문 용어가 아닙니다. 이것이 바로 스킬들이 필요한 순간에 로드되는 이유입니다.
## 스킬 구조 (Skill structure)
이 저장소의 모든 스킬은 동일한 형태를 가집니다:
```markdown
---
name: skill-name
description: Use when <trigger>. Covers <scope>. Trigger on "<phrasing>". Do not use for <neighbour> — see the <other> skill.
...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
템플릿은 templates/SKILL.md에 있습니다. 규칙은 docs/standards.md에 나와 있습니다.
예시 (Examples)
스킬이 사용되는 과정을 보여주는 엔드투엔드(end to end) 워크 세션입니다:
기여 (Contributing)
기준은 행동적 차이입니다. 스킬은 에이전트(agent)의 출력이 로드되었을 때 측정 가능하게 개선되는 경우에만 채택되며, 아무리 잘 작성되었더라도 그렇지 않은 경우는 거부됩니다.
CONTRIBUTING.md를 읽어보세요. 요약하자면 다음과 같습니다:
- 열 가지의 실제 구문으로 트리거링(triggering)을 테스트합니다.
- 스킬 없이 작업을 실행한 후, 스킬과 함께 실행해 봅니다. 차이점을 보여줍니다.
- 템플릿을 정확히 따릅니다.
python scripts/validate.py가 통과해야 하며, python scripts/build_index.py를 다시 실행해야 합니다.
- 내용 없는 채우기(filler)는 금지입니다. 섹션에 할 말이 없다면 스킬이 너무 빈약합니다.
자주 묻는 질문 (FAQ)
왜 400이 아니라 137인가요?
그중 263개는 에이전트가 수행하는 작업을 변경하지 않았기 때문입니다. 커버리지(Coverage)가 목표가 아닙니다. 토큰만 추가하고 기능은 없는 스킬은 순수하게 부정적인 영향을 미칩니다.
모두 필요한가요?
아닙니다. 그리고 모두 설치해서는 안 됩니다. 각 스킬의 설명은 에이전트가 읽을지 결정할 수 있도록 로드됩니다. 작업하는 두세 가지 카테고리만 설치하세요.
Claude 외 다른 에이전트에서도 작동하나요?
형식은 YAML 프런트매터(frontmatter)를 가진 Markdown 파일입니다. 스킬을 지원하는 모든 에이전트 — 또는 컨텍스트에 Markdown을 주입할 수 있는 모든 시스템—에서 사용할 수 있습니다. 트리거링 메커니즘만 다릅니다. docs/installation.md를 참조하세요.
원하지 않을 때 스킬 로드를 중지하려면 어떻게 해야 하나요?
설명이 너무 광범위합니다. 이를 구체화하거나 명시적인 경계를 추가하세요: X에는 사용하지 마세요 — y 스킬을 참고하세요. 이 두 가지는 docs/authoring.md에서 다룹니다.
재무 콘텐츠가 조언인가요?
아닙니다. 이는 방법론입니다 — 포지션 사이징(position sizing), 백테스팅(backtesting), 위험 한도(risk limits) 등이며, 해당 카테고리의 모든 스킬은 이를 명시적으로 밝히고 있습니다. 어떤 것을 거래하라는 추천이 아닙니다.
어떻게 최신 상태로 유지되나요?
스킬은 구식이 됩니다(Skills rot). 자신 있게 진술된 구식 관행은 스킬 자체가 없는 것보다 더 나쁩니다. 각 스킬에는 버전이 포함되며, Notes 섹션에 버전 관련 주의사항이 있습니다. CHANGELOG.md를 참조하세요.
라이선스
MIT. 사용하고, 포크(fork)하고, 배포하세요.