claude-skills
무엇인가
코딩 에이전트에 도메인 지식을 주입하는 지침 패키지 모음이다. 에이전트 실행기 자체가 아니라 실행기가 읽는 자산 계층에 해당한다. 프롬프트에 절차를 매번 적어 넣거나 사내 문서를 대화에 붙여 넣는 방식을 대체한다. 엔지니어링, DevOps, 마케팅, 보안, 컴플라이언스, 재무, 리서치 운영 같은 영역의 작업 절차가 스킬 단위로 나뉘어 있다.
어떻게 동작하나
스킬 하나는 디렉터리 하나다. 안에 SKILL.md가 지침·워크플로·의사결정 프레임워크를 담고, 같은 폴더의 Python CLI 스크립트가 계산·분석·생성을 실행하며, 참조 문서가 템플릿과 체크리스트를 제공한다. Python 도구는 표준 라이브러리만 쓰고 pip 설치를 요구하지 않으며, 각 진입점은 --help 실행으로 검증된다. 저장소는 도구별 미러 트리(.gemini/, .codex/, .vibe/, .hermes/)를 미리 생성해 두고, scripts/convert.sh와 scripts/install.sh가 나머지 도구용 설치를 처리한다.
무엇과 다른가
차이는 지원 범위와 배포 방식에 있다. 단일 도구 전용 스킬 팩과 달리 같은 SKILL.md 표준을 여러 코딩 에이전트가 공유하므로 포맷 변환 없이 설치된다. 보안 쪽은 PreToolUse 훅으로 도구 호출 전에 검사를 끼워 넣는 방식을 쓴다. 스킬 자체를 감사하는 skill-security-auditor 같은 스킬도 포함되어, 외부에서 들여온 스킬의 위험도를 스크립트로 채점할 수 있다.
어떻게 쓰나
Claude Code에서는 플러그인 마켓플레이스를 등록한 뒤 번들 단위로 설치한다. 다른 도구는 scripts/convert.sh --tool all로 변환한 뒤 scripts/install.sh --tool <이름>으로 설치하고, Hermes는 scripts/sync-hermes-skills.py, Mistral Vibe는 scripts/vibe-install.sh를 한 번 실행한다. 스킬을 설치하지 않고 개별 스크립트만 직접 호출할 수도 있다. 예를 들어 python3 finance/saas-metrics-coach/scripts/metrics_calculator.py --mrr 80000 --customers 200 --churned 3 --json처럼 인자를 주고 JSON을 받는다.
전제와 한계
Python 3 실행 환경이 전제다. Windows에서는 core.symlinks=true로 클론해야 미러 트리가 실제 파일로 체크아웃되고, PYTHONUTF8=1을 설정해야 유니코드를 출력하는 도구가 콘솔 코드페이지 문제로 죽지 않는다. 문서 추출기 일부는 선택적으로 서드파티 파서를 쓸 수 있지만 기본 경로는 표준 라이브러리 파서로 동작한다. 버전은 시맨틱 버저닝을 따르고 패치 릴리스 안에서 스크립트 인자와 SKILL.md 구조의 하위 호환을 유지한다.