메뉴
Use when a SKILL.md description, trigger, Quick Reference, or Iron Laws feels vague, too long, or fails to activate the skill correctly
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Use when Ground Truth alignment finds memory contamination and the user explicitly requests scoped cleanup with /cleanse.
Use when registering, reviewing, merging, or rebuilding HXSK glossary term definitions after glossary-detect suggests a candidate or the user invokes /define.
Use when staged changes exist requiring qlty checks, logical split detection, or HXSK phase-scoped conventional commit creation.
Use when validating code for circular imports, layer violations, or design doc logic errors before merging architecture-level changes.
Use when .hxsk/.bootstrap-version is missing (fresh install) or exists (verify/update) to initialize HExoskeleton.
Use when shell scripts need linting/formatting before execution or commit to ensure code quality.
| name | skill-optimizer |
| description | Use when a SKILL.md description, trigger, Quick Reference, or Iron Laws feels vague, too long, or fails to activate the skill correctly |
| version | 1.0.0 |
| trigger | 스킬 문서 개선, description 최적화, trigger 보완, Quick Reference 재작성, Iron Laws 추가, skill doc, CSO 최적화, 스킬 발동 안 됨 |
| allowed-tools | ["Read","Bash"] |
description (≤50 토큰), trigger (한/영 키워드), ## Quick Reference (≤5줄), Iron Laws.hxsk/tools/skill-doc-optimizer/optimize.pypython optimize.py --skill {name} --dry-run → 검토 → --applyskill-testing 스킬로 동작 변화 검증다음 증상 중 하나가 있을 때:
## Quick Reference가 5줄을 초과하거나 절차 단계를 나열함cd .hxsk/tools/skill-doc-optimizer
ls .venv/ 2>/dev/null || python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt -q
python optimize.py --skill {skill_name} --dry-run
출력 항목:
[description] Before / After / 이유[trigger] 추가된 키워드[Quick Reference] 개선안[Iron Laws] 신규 발굴 제약| 필드 | 수용 기준 |
|---|---|
| description | "Use when ..." 패턴 + ≤50 토큰 + 트리거 조건만 포함 |
| trigger | 한국어·영어 혼합 + 누락된 동의어 보완 |
| Quick Reference | ≤5줄 + 볼드 키워드: 설명 형식 + 판단 기준 중심 |
| Iron Laws | NO X WITHOUT Y FIRST 형식 |
python optimize.py --skill {skill_name} --apply
Claude Code에서:
/skill-testing -- {skill_name}
동작 변화가 의도한 방향인지 확인 후 커밋.
# dry-run 전체
python optimize.py --all --dry-run 2>&1 | tee /tmp/skill-opt-review.txt
# 검토 후 일괄 적용
python optimize.py --all --apply
일괄 적용 후 skill-testing으로 각 스킬을 순서대로 검증.
NO APPLY WITHOUT REVIEW FIRST — dry-run 결과를 확인하지 않고 --apply 실행 금지NO COMMIT WITHOUT SKILL-TESTING — skill-testing 검증 없이 변경된 SKILL.md 커밋 금지docs/plans/2026-04-23-dspy-skill-doc-optimizer.md.hxsk/research/ (SkillReducer 논문).hxsk/skills/skill-testing/SKILL.md