cc-skills
무엇인가
cc-skills는 AI 코딩 에이전트에 도메인별 규칙과 절차를 주입하는 스킬 묶음이다. 규율하는 영역은 네 갈래다. 엔지니어링에서는 Conventional Commits v1.0.0 기반 브랜치·워크트리·커밋 메시지 명명, PromQL CLI 사용, Manifest V3 Chrome 확장 아키텍처와 메시징·CSP·스토리지·권한·콘텐츠 스크립트·서비스 워커, CRXJS+Vite HMR, 사이트 런치 체크리스트, 프론트엔드 디자인 탈슬롭(de-slop)을 다룬다. 마케팅·콘텐츠에서는 링크드인 고스트라이팅, 보도자료, 프랑스어·영어 휴머나이저, 카피라이팅 훅·CTA·프로즈·톤오브보이스 생성 규칙을, 개발자 릴레이션스에서는 기술 아티클과 서브스택 고스트라이팅을, 그 외 딥리서치·협상·교육 리포트·Snyk 스캔 컴플라이언스·스킬 점진적 공개 설계를 포함한다.
어떻게 동작하나
각 스킬은 `skills/<name>/` 디렉터리에 `SKILL.md` 진입점을 두는 구조다. `SKILL.md` 상단 YAML 프런트매터의 `description` 필드는 항상 컨텍스트에 로드되어 스킬 발동 조건을 판정하는 데 쓰이고, 본문 `SKILL.md`는 트리거된 시점에만 로드된다. 본문은 작게 유지하고 고급 내용은 내부 참조로 연결된 별도 마크다운 파일에 두어, 실제로 필요한 부분만 컨텍스트에 들어가게 한다. README는 스킬별로 `description` 토큰, `SKILL.md` 토큰, 디렉터리 전체 토큰을 구분해 표기한다.
무엇과 다른가
프롬프트를 매번 직접 쓰거나 단일 `CLAUDE.md`·`AGENTS.md`에 규칙을 몰아넣는 방식과 다르다. 규칙을 원자 단위로 분리하고 온디맨드 로딩으로 컨텍스트 팽창을 막으며, 스킬 간 상호 참조를 전제로 설계했다. 한 스킬이 다른 스킬에 정의된 관례를 참조할 수 있어, 일부만 설치하면 지침의 일부만 보고 일관성이 깨진 상태가 된다. README는 범용 스킬을 전부 함께 설치할 것을 권한다.
어떻게 쓰나
설치는 `npx skills add https://github.com/samber/cc-skills --all`로 전체를, `npx skills add https://github.com/samber/cc-skills --skill promql-cli`로 단일 스킬을 넣는다. Claude Code에서는 `/plugin marketplace add samber/cc` 후 `/plugin install cc-skills@samber`를 실행한다. Gemini CLI는 `gemini extensions install https://github.com/samber/cc-skills`, Codex는 `codex plugin add github:samber/cc-skills`를 쓰고, Cursor·Copilot·OpenCode·Openclaw·Antigravity는 각 클라이언트의 스킬 탐색 디렉터리(`~/.cursor/skills/`, `~/.copilot/skills/`, `~/.agents/skills/`, `~/.openclaw/skills/`, `~/.antigravity/skills/`)로 저장소를 클론한다.
전제와 한계
전제는 Agent Skills 호환 도구 또는 Claude Code 플러그인 마켓플레이스다. Claude Code 외에 Gemini CLI, Codex, Cursor, Copilot, OpenCode, Openclaw, Antigravity를 지원하지만 클라이언트마다 탐색 경로와 설치 명령이 다르다. Golang 관련 스킬은 이 저장소에 없고 별도 저장소 cc-skills-golang으로 분리되어 있다. 스킬은 Claude로 부트스트랩한 뒤 사람이 편집·테스트·리뷰·재작업한 것이며, 일부 스킬만 설치하면 상호 참조가 끊겨 부분적이고 불일치한 지침이 된다.
유사 스킬
- khazix-skills에이전트에 목표 정의·문서 정합성·디스크 정리·AI 뉴스 조회·횡종 리서치·문체 고정 글쓰기 절차를 SKILL.md로 주입하는 Claude Code 스킬 묶음이다.
- agent-rules-books리팩터링·클린 아키텍처·DDD·DDIA 같은 고전 공학서의 설계 규칙을 SKILL.md로 주입해 에이전트의 추상화·의존성·일관성 판단을 규율하는 스킬 묶음이다.
- cc-skills-golangGo 코드 스타일·네이밍·에러 처리·동시성·테스트·관측성 규칙을 SKILL.md 묶음으로 주입해 에이전트가 프로덕션 수준 Go 관례를 따르게 한다.
- pm-claude-skillsPRD 작성·계약서 해독·사후 분석 등 업무별 절차를 SKILL.md로 주입해 프레임워크·출력 템플릿·품질 검사·안티패턴에 따라 산출물을 내도록 강제하는 Claude Code 플러그인이다.
- ok-skills문서 조회·브라우저 자동화·파일 기반 계획 수립 절차를 SKILL.md로 묶어 Claude Code와 Codex에 주입하는 스킬 모음이다.
- skalesSkales 데스크톱 에이전트에 목표 실행·코드워크·워크플로·브라우저 자동화 절차를 SKILL.md로 주입해 다단계 작업을 스스로 수행하게 규율하는 스킬 묶음.