에이전트 스킬 (Agent Skills)
AI 에이전트 스킬은 재사용 가능한 명령어 세트로, 도메인별 전문 지식을 어시스턴트에 확장하며, 컨텍스트를 과부하(bloat)시키지 않도록 필요할 때 로드됩니다. 이 저장소는 @samber가 작성한 마케팅 및 엔지니어링 스킬을 포함합니다.
Golang 관련 스킬은 cc-skills-golang을 방문해 주십시오.
<!-- prettier-ignore-start -->
[!중요!]
Claude를 통해 구축되었습니다. 사람이 편집하고, 테스트하고, 검토하며 재작업했습니다.
여기에는 AI가 만든 쓰레기(slop)는 없습니다. AI로 만든 스킬은 쓸모없습니다.
<!-- prettier-ignore-end -->
<img width="3808" height="1280" alt="image" src="https://github.com/user-attachments/assets/95139f6f-c19c-4041-a010-d94bca594bba" />
🚀 사용 방법 (How to use?)
skills CLI를 사용하여 설치합니다 (범용적이며, 모든 Agent Skills 호환 도구에서 작동합니다):
npx skills add https://github.com/samber/cc-skills --all
<!-- prettier-ignore-start -->
<details>
<summary>Claude 코드</summary>
/plugin marketplace add samber/cc
/plugin install cc-skills@samber
</details>
<details>
<summary>Openclaw</summary>
스킬을 크로스 클라이언트 디스커버리(cross-client discovery) 디렉터리에 복사합니다:
git clone https://github.com/samber/cc-skills.git ~/.openclaw/skills/cc-skills
git clone https://github.com/samber/cc-skills.git ~/.openclaw/workspace/skills/cc-skills
</details>
<details>
<summary>Gemini CLI</summary>
gemini extensions install https://github.com/samber/cc-skills
gemini extensions update cc-skills로 업데이트합니다.
</details>
<details>
<summary>Cursor</summary>
스킬을 크로스 클라이언트 디스커버리 디렉터리에 복사합니다:
git clone https://github.com/samber/cc-skills.git ~/.cursor/skills/cc-skills
Cursor는 .agents/skills/와 .cursor/skills/에서 스킬을 자동 발견(auto-discovers)합니다.
</details>
<details>
<summary>Copilot</summary>
크로스 클라이언트 디스커버리 디렉토리에 스킬을 복사합니다:
/plugin install https://github.com/samber/cc-skills
git clone https://github.com/samber/cc-skills.git ~/.copilot/skills/cc-skills
Copilot은 .copilot/skills/에서 스킬을 자동 디스커버리(auto-discovers)합니다.
</details>
<details>
<summary>OpenCode</summary>
크로스 클라이언트 디스커버리 디렉토리에 스킬을 복사합니다:
git clone https://github.com/samber/cc-skills.git ~/.agents/skills/cc-skills
OpenCode는 .agents/skills/, .opencode/skills/, 그리고 .claude/skills/에서 스킬을 자동 디스커버리(auto-discovers)합니다.
</details>
<details>
<summary>Codex (OpenAI)</summary>
Codex CLI를 통해 플러그인을 설치합니다:
codex plugin add github:samber/cc-skills
codex plugin update cc-skills로 업데이트하십시오. 마켓플레이스 경로가 사용 불가능할 경우 수동 클론으로 폴백(falls back)됩니다:
git clone https://github.com/samber/cc-skills.git ~/.agents/skills/cc-skills
Codex는 ~/.agents/skills/와 .agents/skills/에서 스킬을 자동 디스커버리(auto-discovers)합니다.
</details>
<details>
<summary>Antigravity</summary>
클론하여 크로스 클라이언트 디스커버리 경로에 심링크(symlink)를 만듭니다:
git clone https://github.com/samber/cc-skills.git ~/.antigravity/skills/cc-skills
cd ~/.antigravity/skills/cc-skills && git pull로 업데이트합니다.
</details>
<!-- prettier-ignore-end -->
🧩 스킬 (Skills)
이 스킬들은 **원자적 단위(atomic units), 상호 참조 단위(cross-referencing units)**로 설계되었습니다. 하나의 스킬은 다른 곳에 정의된 규칙을 참조할 수 있습니다. 일부만 설치하면 가이드라인의 부분적이거나 잠재적으로 일관성 없는 뷰를 얻게 됩니다. 최상의 결과를 위해서는 모든 범용 스킬을 함께 설치하십시오.
각 스킬은 skills/<이름>/에 위치하며 SKILL.md가 진입점(entry point) 역할을 합니다. SKILL.md는 고급 마크다운 파일에 대한 내부 참조를 포함하여 간결하게 유지되므로, 관련 콘텐츠만 컨텍스트로 로드됩니다.
- Description (tok): YAML 프론트매터의
description 필드 가중치로, 스킬 트리거를 위해 항상 Claude의 컨텍스트에 로드됩니다.
- SKILL.md (tok): 스킬이 트리거될 때 로드되는 전체
SKILL.md 파일의 가중치입니다.
- Directory (tok): 스킬 디렉터리 내 모든 파일(SKILL.md + 참조된 마크다운 파일)의 가중치입니다.
┌──────────────┐
│ Agent Skills │
└───────┬──────┘
...
| Skill | Error rate gap | Description (tok) | SKILL.md (tok) | Directory (tok) |
|---|
conventional-git | -36% | 73 | 1,446 | 1,446 |
| ... | | | | |
🧪 스킬 평가(Skill evaluations)
| 스킬 사용 시 (With Skill) | 스킬 미사용 시 (Without Skill) | 변화량 (Delta) |
|---|
| 전체 | 98% | 52% | +46pp |
전체 스킬별 상세 내역은 EVALUATIONS.md를 참조하십시오.
📖 스킬 설명(Skills description)
엔지니어링 (Engineering)
chrome-extension
Manifest V3을 사용한 Chrome Extension 개발입니다. 아키텍처, 메시징, CSP(Content Security Policy), 스토리지, 권한, 콘텐츠 스크립트, 서비스 워커 및 Chrome Web Store 배포를 다룹니다.
conventional-git
브랜치 이름 지정, 작업 트리 이름 지정, 커밋 메시지를 위한 Conventional Commits v1.0.0입니다. 자동 변경 로그(auto-changelogs), SemVer 증가, 이슈 닫기를 위해 git 기록을 파싱 가능하게 유지합니다.
crxjs
Vite를 사용한 CRXJS Chrome 확장 프로그램 개발입니다. 팝업/옵션/콘텐츠 스크립트/사이드 패널에 대한 진정한 HMR(Hot Module Replacement) 기능, 타입 안정성이 확보된 Manifest를 위한 defineManifest, 동적 콘텐츠 스크립트 임포트를 제공합니다.
frontend-design-deslop
웹 프론트엔드, 앱, 대시보드 및 랜딩 페이지를 위한 전략 우선 UI 디자인입니다. 브랜드 형용사에 전념함으로써 AI가 생성한 일반적인 미학(Inter + indigo + 둥근 카드)에서 벗어나고, 이후 타이포그래피 및 색상 시스템, 컴포넌트 상태 매트릭스, 레이아웃 리듬, 모션, 아이콘화, 다크 모드를 도출합니다. DESIGN.md 디자인 토큰 계약을 생성합니다.
promql-cli
마케팅 및 콘텐츠
copywriting-cta
기사 끝 부분의 CTA(Call-to-Action) 디자인. 목표, 잠재 고객, 맥락에 대한 인터뷰를 거쳐 카피 + 시각적 형식 + 메커니즘 + A/B 테스트 계획 + 접근성 검사를 생성합니다.
copywriting-hooks
copywriting-prose-creator
산문 메커니즘(어휘집(lexicon), 구문론(syntax), 리듬, 구조)을 PROSE.md 스타일 가이드로 체계화합니다. 세 가지 모드: BUILD (새로운 생성), ADAPT (새 채널에 적용), AUDIT (코퍼스 감사). 콘텐츠 공장, 고스트라이팅 팀, 하우스 스타일 가이드용입니다.
copywriting-tone-of-voice-creator
음성 속성, 변조 행렬(modulation matrix), 어휘집, 채널 규칙과 함께 브랜드 톤앤매너 가이드(TONE.md)를 구축합니다. 처음부터 생성하거나 새 채널에 맞게 조정할 수 있습니다. B2B, B2C, NGO, 공공 부문, 개인 브랜드를 위해 사용됩니다.
humaniseur-fr
프랑스어 텍스트에서 AI 작성 패턴을 제거합니다. 27가지 패턴(AI 어휘, 영어식 표현(anglicisms), 정형화된 도입부, 대시(-) 남용, 아첨하는 어조, 타이포그래피적 단서)을 감지하고 수정합니다.
humanizer-en-asd-ste100
영어 텍스트를 ASD-STE100 Simplified Technical English (Issue 9)로 재작성하고 기술 문서를 정리합니다 — 장식용 이모지, 대화 잔여물, Markdown 잔재, 혼합된 인용 스타일 등을 제거합니다. 유지보수 매뉴얼, 장비 절차서 및 비원어민 또는 기계 번역에 의해 읽히는 모든 기술 텍스트를 위해 9개 섹션에 걸쳐 53가지 규칙(승인된 단어 의미, 기술 명사/동사 범주, 문장 길이 제한, 금지된 동사 시제, 수동태 사용 제한)을 강제합니다.
linkedin-ghostwriting
전략적 인터뷰, 후크 엔지니어링(hook engineering), 게시물 본문을 통해 B2B LinkedIn 고스트라이팅을 수행합니다. 창업자 스토리와 성과를 전환에 초점을 맞춘 게시물로 변환합니다.
press-release-writer
모든 상황과 지역을 위한 전문 보도 자료. 제품 출시, 자금 조달(funding), 파트너십, 위기 관리, M&A, 이벤트 등. 지역별 관례 (유럽, 미주, 아시아 등).
site-launch-checklist
웹사이트 배포를 위한 사전 점검 목록. 분석(Analytics) (GA4, PostHog, GSC), 법률, 보안 헤더, SEO/GEO, 카피라이팅 검토, OpenGraph, favicon, Lighthouse, 접근성(accessibility). Cloudflare + Vercel에 최적화된(Opinionated) 구성.
개발자 관계 (Developer Relations)
substack-ghostwriting
technical-article-writer
시니어 개발자를 위한 기술 아티클 및 블로그 게시물. 무언가를 가르치거나 시간을 절약하는 관점 기반의 실용적이고 예제 중심적인 콘텐츠.
생산성 (Productivity)
deep-research
병렬 웹 검색, 다중 출처 검증 및 인용된 Markdown 보고서를 통한 심층 연구. 시장(market), 경쟁사(competitive), 기술(technical), 학술(academic), 재무(financial), 법률(legal), 트렌드(trend), 커뮤니티(community) 등 11가지 연구 유형 제공.
influence-and-negotiation
합의가 필요한 모든 상호작용을 위한 협상 및 영향력 도구 키트. B2B 영업, 급여, 단체 교섭, 어려운 1:1 면담, 채용, 문화 간 거래 등. 준비, 실시간 코칭, 외교적 초안 작성 포함.
training-report
세션 데이터로부터 구조화된 교육 보고서를 생성합니다. 진행 상황, 습득한 기술 및 결과를 추적합니다.
skill-progressive-disclosure-design
기술 점진적 공개(skill progressive disclosure)를 위한 디자인 패턴. 관련 섹션만 컨텍스트에 진입하도록 기술 콘텐츠를 지연 로딩(lazy loading) 방식으로 구조화합니다.
snyk-agent-scan-compliance
snyk-agent-scan을 위한 규정 준수 전문가(Compliance expert). 보안 스캔 구성을 검증하고 조직 정책과의 준수를 보장합니다.
🎯 스킬 트리거 조정 (Tuning Skill Triggers)
만약 스킬이 너무 자주 또는 충분히 자주 트리거되지 않는다면, [issue 열기]를 통해 설명 변경을 제안해 주세요. SKILL.md의 frontmatter에 있는 description 필드가 주요 트리거링 메커니즘입니다. 작은 단어 조정만으로도 트리거 정확도를 크게 향상시킬 수 있습니다. 일부 SKILL.md에는 또 다른 수준의 제외(exclusion)인 When to use 섹션이 있을 수 있습니다. 마지막으로, SKILL.md는 references/에 위치한 깊은 지식을 가진 참조를 lazy loading 할 수 있는 진입점입니다.
🔄 중복 (Overlap)
팀 자체의 규칙(conventions)이 있다면, 회사 스킬을 생성하고 본문 상단 근처에 오버라이드를 명시적으로 선언하세요: This skill supersedes samber/cc-skills@git-convention skill for [company] projects.
✍️ 기여 (Contribute)
- 스킬 설명당 100 토큰: 무엇을 위한 것인가요? 이 스킬은 언제 사용해야 하나요?
- SKILL.md 당 1,000–2,500 토큰: 메인 파일은 필수적인 내용에 집중하세요.
- 깊이를 위해 보조 마크다운 파일을 사용하세요: 상대 경로 링크(예:
[Logging](./logging.md))로 SKILL.md에서 참조합니다. Claude는 주제가 관련될 때 필요할 때 읽기 때문에, 필요한 시점까지 컨텍스트 예산에 포함되지 않습니다.
- 전체 스킬 및 보조 파일: 최대 10,000 토큰.
- 일반적인 세션에서 동시에 로드되는 스킬: 2~4개입니다. 공존하도록 스킬을 설계하세요.
- 응답 품질 저하를 피하기 위해, 언제든지 총 로드된 SKILL.md가 약 10k 토큰 미만을 유지하도록 하세요.
더 많은 가이드라인은 CLAUDE.md를 확인해 주세요.
💫 혁신에 동참 (Fuel the Revolution)
- ⭐️ 이 리포 저장하기(Star): 당신의 별점이 카페인 엔진에 동력을 공급합니다!
- ☕️ 커피 사주기: 실제로 커피를 마시면서 더 많은 스킬을 구축하는 데 사용할 것입니다.
GitHub Sponsors
📝 라이선스 (License)
Copyright © 2026 [Samuel Berthe]
이 프로젝트는 MIT 라이선스 하에 있습니다.
