개발 계기
팀에서는 레포가 여러개 있습니다. 프론트를 예로 치면 product-desktop, product-mobile 처럼 있는 셈입니다..
다들 Claude Code나 Codex 같은 AI Agent를 쓰기 때문에 스킬을 커밋하여 공유하고 있는데요.
아무래도 같은 프론트라면 공통적인 스킬들(예: 아키텍처 등)도 있을 겁니다.
여기서 몇가지 문제가 생깁니다.
- 스킬 개선하면 레포마다 같은 스킬 복사해서 넣기...
- 다른 브랜치에 커밋했으면 체리픽 해오기...
- 결론 : 스킬 하나 수정하면 = 복사 × 붙여넣기 × 커밋 × N개 레포 × M개 브랜치
- 다른 팀과 공유하려면 zip으로..?
게다가 public github는 보안상 쓰기 어렵기에... 어디에다 올려서 쓸 수 없었습니다.
bitbucket에 올리는거 까지는 괜찮은데 이걸 레포마다 동기화하는건 어떻게 해결하지? 라는 생각이 들었습니다.
심볼릭 링크면 이를 해결할 수 있을 것 같았고, 그래서 만든 CLI도구가 바로 agent-skill-cast 입니다.
마치 마법을 외우는거 처럼 스킬을 agent에게 장착 시키는 CLI도구입니다.
Agent Skill Cast
먼저 설치를 진행합니다.
npm install -g agent-skill-cast- 스킬 소스 등록 (GitHub 레포 또는 로컬 폴더)
먼저 스킬을 가져올 소스를 정합니다.
cast source add https://github.com/your-team/shared-skills
cast source add ~/projects/my-skills- 필요한 스킬 선택
인터렉티브 UI로 스킬을 선택할 수 있습니다.
cast use
cast use my-skills/react선택한 스킬은.claude/skills/, .gemini/skills/, 또는 .codex/skills/ 하위에 심볼릭 링크됩니다
- 동기화
cast source sync명령으로 모든 외부 소스를 pull 받습니다. (로컬 폴더는 symbolic link라 pull X)
작동 방식
- home 디렉터리에 소스를 넣습니다. (외부 레포면 clone, 로컬 폴더면 심볼릭 링크)
cast use로 사용할 때마다 해당 skill을 .claude/skills 하위로 심볼릭 링크를 합니다.
스킬 소스 (GitHub/Local)
↓
~/.asc_sources/shared-skills/ ← 클론/심볼릭 링크
↓
┌────┼────┐
↓ ↓ ↓
프로젝트 A B C
.claude/skills/ → [symlinks]- 디스크 낭비 제로: 복사본이 아닌 심볼릭 링크
- 즉시 업데이트: 소스 변경이 모든 곳에 반영
- 선택적 설치: 각 프로젝트마다 다른 스킬 조합 가능
스킬 감지
소스의 폴더를 기준으로 각 agent 폴더(.claude/skills 등)와 1~2 depth에서 SKILL.md가 존재하는 폴더를 탐색합니다.
- /.claude/skills/react/SKILL.md
- /mobile/screen/SKILL.md
- /docs-write/SKILL.md
와 같은 케이스를 모두 지원합니다.
따라서 실제 사용하고 있는 프로젝트를 소스로 삼거나, https://github.com/ComposioHQ/awesome-claude-skills와 같은 외부 프로젝트를 모두 소스로 삼을 수 있습니다.
미래
앞서 개발 계기에서 이야기한 것 처럼, 현재 레포의 스킬을 특정 git reop를 통해 publish하는 기능 까지 계획했었는데, 생각보다 사용자 플로우 정의가 어려워서 우선은 use에 초점을 맞췄습니다.
사용 예시
