tradermonty/skill-designer

Skill Designer

개요

구조화된 스킬 아이디어 명세로부터 종합적인 Claude CLI 프롬프트를 생성합니다. 이 프롬프트는 Claude에게 저장소 규칙을 따라 완전한 스킬 디렉토리(SKILL.md, YAML 프론트매터, 참조 문서, 헬퍼 스크립트, 테스트 스캐폴딩)를 생성하도록 지시합니다.

사용 시점

• 스킬 자동 생성 파이프라인이 백로그에서 아이디어를 선택하고 claude -p를 위한 설계 프롬프트가 필요할 때
• 개발자가 JSON 아이디어 명세에서 새로운 스킬을 부트스트랩하려 할 때
• 생성된 스킬의 품질 검토 시 점수 평가 루브릭을 인지해야 할 때

전제 조건

• Python 3.9+
• 외부 API 키 필요 없음
• references/ 디렉토리 아래에 참조 파일이 존재해야 함

워크플로우

1단계: 아이디어 명세 준비

다음을 포함하는 JSON 파일(--idea-json)을 수락합니다.

• title: 사람이 읽을 수 있는 아이디어 이름
• description: 스킬이 수행하는 작업
• category: 스킬 카테고리 (예: trading-analysis, developer-tooling)

디렉토리 이름과 YAML 프론트매터 name: 필드로 사용될 정규화된 스킬 이름(--skill-name)을 수락합니다.

2단계: 설계 프롬프트 구축

프롬프트 빌더를 실행합니다.

python3 skills/skill-designer/scripts/build_design_prompt.py \
  --idea-json /tmp/idea.json \
  --skill-name "my-new-skill" \
  --project-root .

스크립트는 다음을 수행합니다.

1. 아이디어 JSON을 로드합니다.
2. 세 가지 참조 파일(구조 가이드, 품질 체크리스트, 템플릿)을 모두 읽습니다.
3. 중복을 방지하기 위해 기존 스킬(최대 20개)을 나열합니다.
4. 완성된 프롬프트를 표준 출력으로 출력합니다.

3단계: Claude CLI에 프롬프트 전달

호출 파이프라인이 프롬프트를 claude -p로 파이프합니다.

python3 skills/skill-designer/scripts/build_design_prompt.py \
  --idea-json /tmp/idea.json \
  --skill-name "my-new-skill" \
  --project-root . \
| claude -p --allowedTools Read,Edit,Write,Glob,Grep

4단계: 출력 검증

Claude가 스킬을 생성한 후 다음을 확인합니다.

• skills/<skill-name>/SKILL.md가 올바른 프론트매터와 함께 존재하는지
• 디렉토리 구조가 규칙을 따르는지
• dual-axis-skill-reviewer로 점수를 매겼을 때 임계값을 충족하는지

출력 형식

스크립트는 표준 출력으로 일반 텍스트 프롬프트를 출력합니다. 성공 시 종료 코드 0, 필요한 참조 파일이 누락된 경우 1을 반환합니다.

리소스

• references/skill-structure-guide.md -- 디렉토리 구조, SKILL.md 형식, 명명 규칙
• references/quality-checklist.md -- 이중 축 검토자 5개 범주 체크리스트 (100점)
• references/skill-template.md -- YAML 프론트매터와 표준 섹션이 포함된 SKILL.md 템플릿
• scripts/build_design_prompt.py -- 프롬프트 빌더 스크립트 (CLI 인터페이스)