메타 스킬 생성기
이 스킬을 사용하여 반복 가능한 워크플로우를 실행 가능하고, 검증 가능하며, 이식 가능한 스킬 패키지로 만드세요. 결과물은 '더 긴 프롬프트'가 아니라, 기본 진입점은 가볍고 세부 사항은 필요에 따라 로드되며 검증 방법을 재현할 수 있는 능력 패키지입니다.
핵심 계약
- 사용자의 실제 워크플로우에서 출발하며, 개인적인 선호 템플릿에서 출발하지 않습니다.
- 파일을 작성하기 전에 먼저 이 작업을 스킬로 만들 가치가 있음을 입증하세요. 일회성 작업을 억지로 스킬 패키지로 만들지 마십시오.
SKILL.md에는 라우팅 인터페이스만 유지합니다: 트리거, 첫 번째 동작, 점진적 로드, 하드 스톱, 검증.- 상세 연구, 제품 설계, 패키지 계획, 트리거 평가, 승인 방법 및 템플릿은
references/,assets/,evals/,scripts/에 배치합니다. - 모호한 의도를 보완하거나, 사용자가 여러 번 선택하게 하거나, MVP를 먼저 고정한 후 일괄 생성해야 하는 스킬은 반드시 Codex
request_user_input/ Claude CodeAskUserQuestion등 호스트 네이티브 의사 결정 표면을 설계해야 합니다. Markdown 선택 카드는 성능 저하를 위한 대기 인터페이스일 뿐, 실제 확인을 가장할 수 없습니다. - 이미지, 비디오, 프레젠테이션, 문서, 보고서, 대시보드 또는 기타 렌더링 결과물은 우선 Image2 / 호스트 네이티브 기능을 확인합니다. MCP, 스크립트, SVG, 정적 미리보기는 성능 저하 또는 보조 경로이며, 반드시 성능 저하 증거가 있어야 합니다.
- 외부 자료는 품질 원칙으로만 추상화해야 합니다. 다른 사람의 명명, 페이지 구조, 시각 시스템, 프롬프트, 예제 또는 상업적 수사를 복사하지 마십시오.
- 모든 전달은 폐쇄 루프여야 합니다: 실행 증거, 검토 결과,
writeback/proposal/none-with-reason/blocked결정을 기록하고, 재사용 가능한 학습 내용을 해당 reference, template, validator, eval 또는 example에 다시 기록합니다.
점진적 로드
현재 단계에 필요한 파일만 읽습니다:
| 현재 단계 | 읽을 파일 | 사용 시기 |
|---|---|---|
| 의도 및 도메인 연구 | references/intent-domain-research.md, assets/domain-research-brief-template.md | 사용자 입력이 모호하거나, 도메인이 낯설거나, 전략적 판단처럼 보이거나, 일회성 프롬프트일 가능성이 있을 때; 먼저 도메인 연구 브리프를 작성하고, 증거가 부족하면 research-needed 표시. |
| 표면 및 산물 체인 | references/experience-surface-model.md | 스킬이 파일, 미디어, 스크린샷, 프레젠테이션, 보고서, 대시보드 또는 기타 가시적인 결과물을 생성해야 할 때. |
| 제품화 설계 | references/product-design.md | 패키지 내 파일, 3분 내에 볼 수 있는 결과, 사용자 여정 또는 최초 공개 표면을 결정해야 할 때. |
| 실행 계약 | references/skill-contract.md | 후보 스킬 패키지를 작성하거나 변경하기 전에 사용. |
| 소스 추상화 경계 | references/source-abstraction-boundary.md | 외부 사례, 내부 샘플 또는 경쟁 자료를 사용할 때, 먼저 추상화한 후 다시 작성. |
| 패키지 계획 | assets/package-plan-template.md | 편집 전에 SKILL.md, 참조 파일, 자산, 스크립트, 평가 및 예제를 매핑. |
| 멀티모달/도구 경로 | references/multimodal-tooling.md, assets/multimodal-prompt-brief-template.md | 스킬이 Image2, 호스트 미디어 기능, MCP, 로컬 렌더러 또는 스크립트에 의존할 때; 먼저 로컬 기능 목록과 멀티모달 브리프를 기록. |
| 대화형 의사 결정 및 MVP 게이트 | references/interactive-mvp-product-skill.md | 스킬이 모호한 의도에서 여러 결정을 내리거나, 스타일/커버/첫 화면/MVP를 고정한 후 일괄 생성을 하거나, Codex, Claude Code 호스트 간에 확인 프로세스를 재사용해야 할 때. |
| 평가 설계 | references/evaluation-method.md, evals/trigger-eval.json | 트리거 평가, 출력 평가, 기준 비교, 회귀 또는 승인 검사를 설계할 때. |
| 릴리스 게이트 | references/release-gate.md, assets/acceptance-run-template.md | 배포, 마이그레이션 또는 다른 사람에게 전달할 수 있다고 주장하기 전에. |
| 폐쇄 루프 거버넌스 | references/closed-loop-governance.md, assets/loop-run-record-template.md | 승인, 실패, 회고, 드리프트, 릴리스 준비 또는 사용자가 '폐쇄 루프'를 요청할 때; 실행 기록과 쓰기 저장 결정을 반드시 명시. |
assets/의 .md 파일은 사람이 작성하는 작업 템플릿이고, .json 파일은 스크립트나 검증이 읽는 구조 데이터입니다. 해당 결과물을 생성할 때만 읽습니다. scripts/는 검증, 변환 또는 패키징 시에만 실행하며, 스크립트 내용을 대화 컨텍스트에 붙여넣지 마십시오.
워크플로우
- 분류:
new-skill,refactor-skill,evaluate-skill,package-plan, 또는not-a-skill인지 판단합니다. - 가져오기 및 연구: 패키지 결정, 결과물 표면, 도구 경로 또는 승인 기준을 변경할 증거만 수집합니다.
- 설계: 결과, 트리거 경계, 입력/출력, 로컬 기능 경로, 대화형 의사 결정 표면, MVP 고정 게이트, 패키지 구조 및 공개 실패 패턴을 결정합니다.
- 구축: 현재 목표를 위해 반드시 건드려야 하는 최소 파일 세트만 생성하거나 수정합니다.
- 검증: 패키지 검증, 폐쇄 루프 검증 및 도메인 검증을 실행합니다. 구조 증거, 결과물 증거, 실행 증거 및 수동 확인이 각각 무엇을 입증하는지 보고합니다.
- 폐쇄 루프: 실행 기록을 작성합니다.
writeback,proposal,none-with-reason또는blocked를 결정합니다. 재사용 가능한 학습 내용만 규칙에 다시 기록하고, 채팅 요약을 폐쇄 루프로 가장할 수 없습니다.
패키지 구조
기본 파일:
SKILL.md: 가벼운 진입점, 트리거 및 실행 계약을 담당합니다.references/: 도메인 규칙, 제품 모델, 기능 경로, 소스 추상화, 평가 방법, 릴리스 게이트.assets/: 작성 가능한 템플릿, 워크시트, 구조 데이터 또는 프롬프트 브리프.scripts/: 결정론적 검증, 변환, 렌더링 또는 패키지 검사.evals/: 트리거 평가 및 회귀 테스트 케이스.examples/: 작고 실제적인 입력/출력 예제. 개인 기록, 내부 평가 또는 가짜 실행 증거를 작성하지 않습니다.
새 파일은 특정 실패를 방지하거나 스킬을 더 쉽게 실행할 수 있도록 할 때만 추가합니다. 연구 노트를 저장하기 위해 참조 파일을 추가하지 마십시오.
하드 스톱
다음 상황이 발생하면 먼저 중단하고 차단 상황을 설명합니다:
- 작업이 일회성 프롬프트일 뿐, 반복 가능한 워크플로우가 아닙니다.
- 도메인 표면이 추측에 불과하고, 사용자 자료, 로컬 증거 또는 현재 소스 증거의 뒷받침이 없습니다.
- 멀티모달 스킬에 로컬 기능 목록과 출력 증거 경로가 없습니다.
- 사용자의 여러 차례 의사 결정 또는 MVP 확인이 필요하지만, 네이티브 선택 도구, 성능 저하 대기 인터페이스, 확인 상태 필드 및 일괄 생성 중지 규칙이 없습니다.
- 패키지가 생성 파일에 의존하지만, 파일, 스크린샷, 미디어 또는 렌더링 결과의 존재를 증명할 방법이 없습니다.
- 트리거 범위가 다른 활성 스킬 패키지와 중복되지만, 라우팅 경계가 없습니다.
- 설계가 비공개 평가 기록, 내부 회고, 구현 상처를 노출하거나, 특정 외부 프로젝트를 모방한 것으로 보일 수 있습니다.
검증
패키지 루트 디렉토리에서 다음을 실행합니다:
python scripts/check_meta_skill_package.py .
python scripts/check_closed_loop.py .
생성된 패키지에 자체 스크립트가 있으면 실제 결과물에 대해서도 실행합니다. 검증 시 구조 검사, 생성된 결과물 증거, 실행/도구 증거 및 수동 승인을 명확히 구분해야 합니다. 한 수준의 통과가 전체 통과를 대체할 수 없습니다.
최종 보고서
한국어로 보고합니다: 변경된 파일, 패키지 결정, 트리거 경계, 점진적 로드 다이어그램, 검증 명령어, 증거 수준, 폐쇄 루프 결정 및 잔여 위험. 사용자가 이 스킬 패키지가 실제로 사용하기 더 쉬운지 판단할 수 있도록 작은 전후 비교 또는 출력 조각을 제공합니다.