菜单
현재 스킬 repo의 skill을 선택하여 Claude Code·Agents·Antigravity·Codex·Junie 경로(~/.claude/skills/ 등 5개)에 설치합니다. --all(전체 경로)·--clear(클린 재설치)·--self(self-install 부트스트랩) 옵션을 지원합니다. skill 설치, install skills, 스킬 배포, 스킬 재설치, self-install 시 사용합니다.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
이슈 단위로 스펙, 실행 계획, 수행 요약을 관리하는 워크플로우입니다. 이슈 작업, issue, 이슈 시작, 이슈 완료, 워크플로우 복구(--workflow-only), 이어하기, resume, 작업 재개(--resume), 이슈 정리, 작업공간 정리, 정리(--clear), audit 리포트 검토·피드백 후 승인 보정(--response) 시 사용합니다.
이슈 스펙 대비 구현 완료 여부를 독립 감사인 관점에서 검증합니다. 이슈 감사, issue audit, 구현 검증, 크로스체크 시 사용합니다.
대화 중 중요한 맥락(배경, 결정, 미결 사항, 다음 액션)을 `.ai/99_workspace/notes/` 아래 마크다운 파일로 저장합니다. 맥락 저장, context save, 임시 저장, 논의 스냅샷, 작업 메모 시 사용합니다.
PR 제목과 메시지를 정책(Conventional Commits 제목 + 이슈별 비즈니스/테크 관점)에 맞게 작성합니다. PR 작성, PR 메시지·설명 작성, pull request, 풀리퀘스트, PR 올리기 전 정리, 리뷰어용 설명 정리 시 사용합니다. 실제 PR 생성·제출이 아니라 메시지 텍스트 작성용입니다.
멀티 repo 워크스페이스 루트의 로비 `.ai/AI-CONTEXT.md`를 생성하거나 진단·재구성합니다. `ai-workspace`의 자매 스킬로, building 안내판(=lobby) 역할의 lean 라우터를 만듭니다. 로비, lobby, AI-CONTEXT.md, building 인덱스, 워크스페이스 안내판 작업 시 사용합니다.
프로젝트를 분석하여 README.md를 생성하거나 최신 상태로 재작성합니다. README.md가 없으면 템플릿에 따라 새로 작성하고, 이미 있으면 현재 프로젝트 구조에 맞게 재작성합니다. README 작성, README 갱신, readme sync, 리드미 최신화 시 사용합니다.
| name | install-skills |
| description | 현재 스킬 repo의 skill을 선택하여 Claude Code·Agents·Antigravity·Codex·Junie 경로(~/.claude/skills/ 등 5개)에 설치합니다. --all(전체 경로)·--clear(클린 재설치)·--self(self-install 부트스트랩) 옵션을 지원합니다. skill 설치, install skills, 스킬 배포, 스킬 재설치, self-install 시 사용합니다. |
이 저장소의 skill을 선택하여 설치합니다.
클린 설치(기존 설치본 삭제 후 복사)와 개발 전용 경로(tests/ 등) 배포 제외의 단일 출처는 설치 절차 5단계입니다.
규칙 배경(결정적 헬퍼의 테스트는 스킬 디렉토리에 함께 두되 배포에서 제외)은 이 repo의 ADR 0001에 있습니다 — repo 전용 문서라 설치본에서는 열람할 수 없어 링크하지 않습니다.
| 옵션 | 설치 경로 |
|---|---|
| (없음) | ~/.claude/skills/ |
--claude | ~/.claude/skills/ |
--agents | ~/.agents/skills/ |
--antigravity | ~/.gemini/config/skills/ |
--codex | ~/.codex/skills/ |
--junie | ~/.junie/skills/ |
--all | 모두 |
| 옵션 | 설명 |
|---|---|
--clear | 설치 전 대상 skills 디렉토리 내부를 비웁니다 — 동작은 설치 절차 2단계. |
--self | install-skills 자신을 설치 대상에 포함합니다 — 절차는 아래 Self-install 부트스트랩. |
--clear는 스킬명 변경 등으로 기존 스킬이 남아 있을 때 유용합니다. 디렉토리 자체(~/.claude/skills/등)는 유지됩니다.
install-skills는 홈에 한 벌만 두고, 어느 스킬 repo에서든 복제본 없이 실행하는 것을 전제로 합니다.
/install-skills --self를 실행해 install-skills 자신을 홈(예: ~/.claude/skills/install-skills/)에 설치합니다./install-skills를 실행하면, 그 repo에 복제본이 없어도 홈 설치본이 그 repo의 skill을 스캔·설치합니다.self-install에도 일반 설치와 동일한 절차(클린 설치, 배포 제외 패턴)가 적용됩니다.
설치 대상 목록은 본문에 고정하지 않고, 실행 시점에 저장소를 스캔하여 동적으로 구성합니다.
스킬 repo 판별 가드 — 스캔 전에 cwd가 스킬 repo인지 먼저 확인합니다. */SKILL.md가 1건 이상 매칭되면 통과, 하나도 매칭되지 않으면 스킬 repo가 아닌 것으로 판정하고 경고 후 안전하게 중단합니다. 단일 스킬 repo도 지원 대상이므로 1건 통과는 설계 의도이며, 다만 1건만 매칭되면 해당 디렉토리가 스킬 repo가 맞는지 사용자에게 확인한 뒤 진행합니다 (이 확인은 아래 스니펫이 아니라 지침을 실행하는 AI가 대화로 수행합니다 — 스니펫은 0건 차단만 담당합니다). 임의의 cwd에서 실수로 실행해 엉뚱한 디렉토리를 소스로 삼는 오설치를 막기 위한 가드입니다.
# 스킬 repo 판별 가드 — */SKILL.md 가 0개면 중단 (셸 내장만 사용 — bash nullglob·zsh 모두 안전)
found=false
for f in */SKILL.md; do [ -e "$f" ] && { found=true; break; }; done
if [ "$found" != "true" ]; then
echo "스킬 repo가 아닙니다 (*/SKILL.md 없음) — 설치를 중단합니다." >&2
exit 1
fi
가드를 통과한 경우에만 아래 스캔을 진행하며, "스캔 목록 제시 → 사용자 선택" 절차는 기존과 동일하게 유지합니다.
SKILL.md를 보유한 1차 하위 디렉토리를 모두 수집합니다. install-skills 자신은 설치 대상에서 제외하되, --self가 지정된 경우에는 제외를 해제하고 자기 자신을 대상에 포함합니다.SKILL.md frontmatter의 description에서 가져옵니다.# 기본: install-skills 자신 제외. --self 지정 시(self_install=true) 제외 해제.
for f in */SKILL.md; do
d=$(dirname "$f")
{ [ "$self_install" = "true" ] || [ "$d" != "install-skills" ]; } && echo "$d"
done
--claude, --agents, --antigravity, --codex, --junie, --all, --clear, --self 옵션을 파싱합니다. 옵션이 없으면 기본값 ~/.claude/skills/를 사용합니다.--clear가 지정된 경우, 대상 skills 디렉토리 내부의 모든 하위 항목을 삭제합니다.
rm -rf <target-skills-dir>/*
--exclude 플래그가 제외 패턴(tests/, *.test.*)의 단일 출처입니다 — ADR·AI-CONTEXT는 이 목록을 복제하지 않고 이 절차를 참조만 합니다.
선택 목록은 배열로 다뤄 zsh/bash 모두에서 단어 분리에 깨지지 않게 합니다.
# 선택한 skill 목록과 대상 경로 (배열 — zsh word-splitting 회피)
skills=(git-commit git-pr issue-work)
target="$HOME/.claude/skills"
for s in "${skills[@]}"; do
rm -rf "$target/$s"
rsync -a --exclude 'tests/' --exclude '*.test.*' "$s/" "$target/$s/"
# rsync 미가용 환경 fallback (tests/ 디렉토리 + *.test.* 파일 모두 제외):
# cp -r "$s" "$target/" && rm -rf "$target/$s/tests" && find "$target/$s" -name '*.test.*' -delete
done
verify-install.sh 헬퍼로 설치 결과를 결정적으로 먼저 확인합니다(합/불은 exit code). 헬퍼는 홈 설치본 우선, 없으면 cwd 폴백 순으로 탐색합니다 — 홈 설치본(~/.claude/skills/install-skills/scripts/verify-install.sh)이 있으면 그것을 사용하고, 없으면 cwd(스킬 repo) 상대 경로 install-skills/scripts/verify-install.sh로 폴백합니다. 다른 스킬 repo에는 헬퍼 복제본이 없으므로 홈 설치본 탐색이 먼저입니다. AI는 그 PASS/FAIL 출력을 읽어 누락·경로 불일치를 준결정적으로 크로스체크합니다 — 결정적 결과가 우선이고 AI 판단은 보완입니다.
# 헬퍼 탐색: 홈 설치본 우선, 없으면 cwd(스킬 repo) 폴백
verify="$HOME/.claude/skills/install-skills/scripts/verify-install.sh"
[ -x "$verify" ] || verify="install-skills/scripts/verify-install.sh"
# 5단계의 skills·target 배열을 그대로 재사용 — 공통 검증(모든 대상에 적용).
"$verify" --target "$target" "${skills[@]}"
--antigravity 또는 --all) --antigravity-legacy를 붙여 구 Antigravity skills 경로의 레거시 잔존을 추가 점검합니다. 적용 조건·판정 기준·배경 상세는 references/antigravity-legacy.md를 참조하세요.
# Antigravity 대상 경로에 대해서만 추가 실행. $verify 는 위 헬퍼 탐색 결과를 재사용.
"$verify" --target "$antigravity_target" --antigravity-legacy "${skills[@]}"
all을 선택하면 모든 skill을 설치합니다 (install-skills 제외, --self 지정 시 포함).~/.claude/skills/에 복사된 skill은 Claude Code가 자동 인식합니다. CLAUDE.md에 별도 등록이 필요 없습니다.--all을 사용하면 모든 경로에 동일한 skill을 설치합니다.