skill-port은(는) 무엇을 하나요?
AI 에이전트 스킬을 이식 가능한 디렉토리 패키지로 묶어, 머신 간/하네스(Claude Code/Goose/Codex/Cursor/...) 간에 동일한 경험으로 복원합니다.
사용법
패킹하기
# 현재 위치의 스킬 디렉토리를 패킹
skill-port pack ./my-skill
# 특정 출력 파일명 지정
skill-port pack ./my-skill -o my-skill.tar.gz
복원하기
# 패키지 파일을 현재 하네스에 복원
skill-port restore my-skill.tar.gz
# 특정 대상 디렉토리 지정
skill-port restore my-skill.tar.gz -d ~/.claude/skills
옵션
| 옵션 | 설명 |
|---|---|
-o, --output | 출력 패키지 파일명 지정 |
-d, --dest | 복원 대상 디렉토리 지정 |
-h, --help | 도움말 출력 |
--version | 버전 정보 출력 |
지원하는 하네스
- Claude Code (
~/.claude/skills/) - Goose (
~/.goose/skills/) - Codex (
~/.codex/skills/) - Cursor (
~/.cursor/skills/)
예제
팀 내 스킬 공유
# 스킬 패킹
cd ~/projects/my-awesome-skill
skill-port pack . -o my-awesome-skill.tar.gz
# 팀원에게 tar.gz 파일 전달 (Git, Slack, 이메일 등)
# 팀원이 복원
skill-port restore my-awesome-skill.tar.gz
CI/CD 파이프라인에서 사용
# .github/workflows/restore-skill.yml
steps:
- name: 복원 스킬
run: |
skill-port restore ./path/to/skill.tar.gz
참고
- 패키지 파일은 tar.gz 형식입니다.
- 복원 시 기존 스킬과 충돌하면 덮어씁니다.
- 하네스별 디렉토리 구조가 다를 경우 자동으로 감지하여 적절히 배치합니다.
- 스킬의 메타데이터(이름, 버전, 설명 등)는 패키지 내
SKILL.md를 통해 보존됩니다.