skill-create
/authoring:skill-create ["<아이디어>"]
의도 포착 · 인터뷰 · 초안 · eval 루프 · description 튜닝 · 패키징의 8단계로 스킬 하나를 만든다. 마지막 Phase 8 은 skill-check 게이트이고, FAIL/WARN 이면 곧장 skill-refactor 로 넘긴다.
authoring skills
AI 코딩 하네스가 자기 자신에 대해 읽는 산출물을 다루는 스킬 6개 — SKILL.md, 셸 스크립트, help 텍스트, 명령 이름. 스킬마다 설명서 1건과 사용 예시 1건이 있습니다.
skill-create─▶ skill-check─▶ skill-refactor
대상 파일을 고치는 스킬은 셋뿐입니다 —
skill-create, skill-refactor, ux-guidelines. skill-check 와 sh-check 는 리포트만 내는 read-only 감사이고, command-rename 은 매핑과 이슈까지만 만들고 이름은 바꾸지 않습니다. 쓰는 쪽도 계획을 먼저 보이고 확인을 받은 뒤에 씁니다.
1스킬 6개
skill-check
/authoring:skill-check [path/to/SKILL.md | plugin:skill] | -d | -r | -R
SKILL.md 하나를 구조 · UX · 모델 티어 메타데이터 · 보안 선언 · 컨텍스트 예산 · 이식성의 19개 항목으로 감사하고 전부 PASS/WARN/FAIL/N/A 를 매긴다. 실패에서 멈추지 않고 끝까지 읽으며, 파일은 절대 고치지 않는다. -d/-r/-R 일괄 모드는 실패한 스킬마다 이슈를 1건씩(upstream 우선, 중복 방지) 확인 한 번 뒤에 등록한다.
skill-refactor
/authoring:skill-refactor [path/to/SKILL.md]
100줄을 넘긴 SKILL.md 에서 템플릿 · 표 · 긴 예시를 references/ 로 빼내 100줄 이하로 줄인다. 계획을 먼저 제시하고 확인을 받기 전에는 아무 파일도 쓰지 않는다. 이미 100줄 이하면 통과했다고 알리고 멈춘다.
sh-check
/authoring:sh-check [path/to/script.sh]
*.sh 를 구조 5개(shebang · 인터랙티브 가드 · 섹션 · 네이밍 · zsh 호환)와 UX 5개(help 플래그 · ux_lib · 입력 검증 · 판정 · 다음 행동)로 감사한다. PASS 와 N/A 행에는 조언을 붙이지 않는다.
ux-guidelines
/authoring:ux-guidelines [target]
셸 함수와 help 텍스트의 raw echo · printf · ANSI 코드를 ux_header / ux_section / ux_bullet 같은 의미 있는 호출로 바꾼다. 함수 하나를 고치는 모드와 shell-common/** 을 훑어 리포트만 쓰는 모드가 갈린다. 요청받지 않은 동작 변경은 하지 않는다.
command-rename
/authoring:command-rename <family> <convention> [remote]
명령 패밀리 하나의 정의와 모든 참조 지점을 찾아 old→new 매핑을 짜고, 네이밍 SSOT 와 대조해 규칙 공백이 있으면 그것까지 이슈로 남긴다. 소스는 건드리지 않는다 — 실제 리네임은 나중에 /gh-flow:issue 가 돌린다.
2세 개의 분리선
어느 스킬을 부를지는 무엇을 가리키고 있는가로 갈립니다.
감사 — skill-check / skill-refactor
감사가 재작성이 필요한지를 말해 주므로 skill-check 를 먼저 돌립니다. skill-refactor 는 그 판정 뒤에 오고, 리포트 마지막 줄이 다시 skill-check 를 가리킵니다. skill-create 는 같은 게이트를 Phase 8 에서 스스로 돕니다.
파일 종류 — skill-check / sh-check
같은 감사 형식을 서로 다른 파일에 적용한 한 쌍입니다. SKILL.md 는 skill-check, *.sh 는 sh-check. ux-guidelines 는 sh-check 가 6·7번에서 지적한 출력 코드를 실제로 고치는 쪽입니다.
설계 — command-rename
여기서 유일하게 코드가 아니라 이름을 다룹니다. 매핑 · 하위호환 결정 · 위험과 롤백까지 설계해 추적 이슈로 남기고 끝냅니다. 실행은 다른 스킬의 몫이라는 경계가 이 스킬의 정의입니다.