migrate-skill-agent

v2026.09.25

skills-store에서 명시한 skill 또는 agent를 찾아 git pull 후 홈 디렉토리나 현재 프로젝트의 Claude/Codex skills/agents로 설치합니다.

GitHub
Install command
npx skhub add mineru98/migrate-skill-agent
Markdown
SKILL.md

$ARGUMENTS: 설치할 skill 또는 agent 이름과 옵션

skills-store에서 지정한 skill 또는 agent를 설치해줘.

다음 순서로 진행해:

  1. $ARGUMENTS에서 이름과 옵션을 확인해
  2. --target home 또는 --target project가 없으면 사용자에게 홈 디렉토리 업데이트인지 현재 프로젝트 업데이트인지 물어봐
  3. 이 스킬의 scripts/migrate-skill-agent.sh를 사용해
  4. 원본 $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 미리보기 없음
  • 백업 없음
  • 롤백 없음
  • 해시 비교 없음
  • 전체 동기화 없음
  • 변경 항목 자동 감지 없음
Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.09.25

Published

Sep 25, 2026

Category

Uncategorized

License

MIT

Source path

.codex/skills/migrate-skill-agent

Default branch

main

Latest commit

c1ff575

Tree SHA

f1b3ecf