# Migrate Skill Agent

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

- Skill: `mineru98/migrate-skill-agent` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add mineru98/migrate-skill-agent`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mineru98/migrate-skill-agent/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: Mineru98 (https://skillmd.com/u/mineru98)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/mineru98/migrate-skill-agent

---


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

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

다음 순서로 진행해:

1. `$ARGUMENTS`에서 이름과 옵션을 확인해
2. `--target home` 또는 `--target project`가 없으면 사용자에게 홈 디렉토리 업데이트인지 현재 프로젝트 업데이트인지 물어봐
3. 이 스킬의 `scripts/migrate-skill-agent.sh`를 사용해
4. 원본 `$ARGUMENTS`를 셸 문자열로 그대로 붙이지 말고, 파싱한 값을 각각 따옴표로 감싸서 다음 형태로 실행해:

```sh
"<이 스킬의 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

저장소를 못 찾았을 때만 동작한다. 탐색 순서는 그대로 쓴다.

```text
$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` 대신 심볼릭 링크를 건다.

```text
~/.claude/skills/issue-create  ->  <store>/.claude/skills/issue-create
```

저장소에서 `git pull` 하면 설치본이 함께 갱신된다. 여러 스킬을 매번 다시 복사할 필요가 없다.
기존 대상이 실제 디렉터리든 심볼릭 링크든 지우고 새로 건다.

**주의**: 링크된 스킬을 고치면 skills-store 저장소가 직접 수정된다. 실험적으로 고칠 거라면 `--link` 를 쓰지 않는다.

## --flavor

`issue-*` 스킬군이 자동 설치할 때 쓴다. 실행 중인 런타임이 Claude 계열이면 `--flavor claude`, Codex 계열이면 `--flavor codex` 를 넘겨 불필요한 한쪽을 설치하지 않는다.

```bash
migrate-skill-agent.sh --skill issue-create --target home --link --clone --flavor claude
```

## 하지 않는 일

- diff 미리보기 없음
- 백업 없음
- 롤백 없음
- 해시 비교 없음
- 전체 동기화 없음
- 변경 항목 자동 감지 없음