skills-ref

name	skills-ref
description	스킬 디렉토리를 스캔하여 CLAUDE.md에 Available Skills 섹션을 XML 구조로 생성합니다. 스킬 등록, 스킬 목록 생성, CLAUDE.md 스킬 섹션, skills ref, 스킬 인덱스, available skills 작성 요청 시 활성화.

Skills Ref

스킬 디렉토리를 스캔하여 CLAUDE.md에 <available-skills> XML 섹션을 생성합니다.

CRITICAL: 사용자 입력 먼저

이 스킬은 어떤 분석이나 명령 실행보다 먼저, 반드시 사용자에게 아래 두 가지를 질문해야 합니다. 사용자 응답 없이 절대 진행하지 마세요.

1. 스캔할 스킬 디렉토리는 어디인가요? (예: .claude/skills, skills, 기타 경로)
2. CLAUDE.md 파일 경로는? (예: CLAUDE.md, .claude/CLAUDE.md, 기타)

• skills/ 같은 기본값을 가정하지 마세요. 반드시 사용자에게 물어보세요.
• 레포마다 스킬 디렉토리가 다릅니다:
  • 일반 프로젝트 → .claude/skills/
  • 스킬 라이브러리 레포 → skills/ (배포용), .claude/skills/ (프로젝트 자체용)
  • 모노레포 → packages/{pkg}/.claude/skills/

사용자가 디렉토리를 알려준 후에만 아래 워크플로우를 진행합니다.

---

워크플로우

Step 1: uvx 실행 환경 확인

uvx로 skills-ref를 실행할 수 있는지 확인합니다:

uvx --from skills-ref agentskills --help 2>/dev/null && echo "사용 가능" || echo "사용 불가"

uvx가 없는 경우

사용자에게 안내합니다:

`uvx` 명령을 사용할 수 없습니다. `uv`를 설치하면 바로 사용할 수 있습니다:

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh

또는 내장 스크립트로 대체할 수 있습니다 (스킬 검증 기능은 제외).

### Step 2: 스킬 스캔

#### uvx 사용 가능한 경우 (권장)

```bash
# 모든 스킬의 프롬프트 XML 생성
uvx --from skills-ref agentskills to-prompt {skills_dir}/*/

# 개별 스킬 검증도 함께 수행
for skill in {skills_dir}/*/; do
  uvx --from skills-ref agentskills validate "$skill"
done