| name | migrate-skill-agent |
| description | skills-store에서 명시한 skill 또는 agent를 찾아 git pull 후 홈 디렉토리나 현재 프로젝트의 Claude/Codex skills/agents로 설치합니다. |
| argument-hint | [--skill|--agent] <name> [--target home|project] [--clone] [--link] [--flavor claude|codex] |
$ARGUMENTS: 설치할 skill 또는 agent 이름과 옵션
skills-store에서 지정한 skill 또는 agent를 설치해줘.
다음 순서로 진행해:
$ARGUMENTS에서 이름과 옵션을 확인해
--target home 또는 --target project가 없으면 사용자에게 홈 디렉토리 업데이트인지 현재 프로젝트 업데이트인지 물어봐
- 이 스킬의
scripts/migrate-skill-agent.sh를 사용해
- 원본
$ARGUMENTS를 셸 문자열로 그대로 붙이지 말고, 파싱한 값을 각각 따옴표로 감싸서 다음 형태로 실행해:
"<이 스킬의 scripts/migrate-skill-agent.sh 경로>" --skill "<name>" --target home
agent를 설치할 때는 --agent "<name>"를 사용하고, 현재 프로젝트에 설치할 때는 --target project를 사용해.
옵션
--skill <name>: skill만 검색해서 설치
--agent <name>: agent만 검색해서 설치
<name>: skill과 agent를 검색. 둘 다 있으면 명시 옵션을 요구
--target home: ~/.claude와 ~/.codex 아래에 설치
--target project: 현재 프로젝트의 .claude와 .codex 아래에 설치
--clone: 로컬에 skills-store 체크아웃이 없으면 clone 한다
--link: 복사 대신 심볼릭 링크로 설치한다
--flavor claude|codex: 한쪽 계열만 설치한다 (기본은 양쪽)
동작
- 사용자 디렉토리에서
skills-store 프로젝트를 찾는다
- 찾은 저장소에서
git pull을 실행한다
git pull이 실패하면 복사하지 않고 중단한다
- 지정한 항목만 복사한다
- 대상 선택 이후에는 기존 항목을 바로 덮어쓴다
- 완료 조건은 복사 성공과 필수 파일 존재 확인이다
--clone
저장소를 못 찾았을 때만 동작한다. 탐색 순서는 그대로 쓴다.
$MIGRATE_SKILLS_STORE_PATH → $PWD → $HOME/SourceCode/skills-store → $HOME/skills-store
clone 위치는 $HOME/SourceCode/skills-store → $HOME/skills-store 중 부모 디렉터리가 이미 있는 첫 곳이다.
/tmp 같은 임시 디렉터리를 쓰지 않는다. 이후에도 git pull 로 계속 최신을 유지할 수 있어야 하고, --link 설치가 의미를 가지려면 위치가 안정적이어야 하기 때문이다.
--link
rsync/cp 대신 심볼릭 링크를 건다.
~/.claude/skills/issue-create -> <store>/.claude/skills/issue-create
저장소에서 git pull 하면 설치본이 함께 갱신된다. 여러 스킬을 매번 다시 복사할 필요가 없다.
기존 대상이 실제 디렉터리든 심볼릭 링크든 지우고 새로 건다.
주의: 링크된 스킬을 고치면 skills-store 저장소가 직접 수정된다. 실험적으로 고칠 거라면 --link 를 쓰지 않는다.
--flavor
issue-* 스킬군이 자동 설치할 때 쓴다. 실행 중인 런타임이 Claude 계열이면 --flavor claude, Codex 계열이면 --flavor codex 를 넘겨 불필요한 한쪽을 설치하지 않는다.
migrate-skill-agent.sh --skill issue-create --target home --link --clone --flavor claude
하지 않는 일
- diff 미리보기 없음
- 백업 없음
- 롤백 없음
- 해시 비교 없음
- 전체 동기화 없음
- 변경 항목 자동 감지 없음