Communitygithub.com

KimYx0207/meta-skill-creator

이식 가능한 에이전트 스킬로, 재사용 가능한 스킬을 설계, 리팩토링, 검토하는 데 사용됩니다.

meta-skill-creator란 무엇인가요?

이 스킬은 '스킬 생성기'로서, 사용자의 반복 가능한 워크플로우를 실행 가능하고, 검증 가능하며, 이식 가능한 스킬 패키지로 변환합니다. 단순히 긴 프롬프트를 생성하는 것이 아니라, 가벼운 진입점, 필요에 따라 로드되는 세부 사항, 재현 가능한 검증 방법을 갖춘 능력 패키지를 만드는 데 초점을 맞춥니다. Codex, Claude Code 등 다양한 AI 에이전트 호스트에서 사용할 수 있도록 설계되었으며, 사용자 의도 분석, 제품 설계, 평가 설계, 폐쇄 루프 거버넌스 등의 단계를 거쳐 스킬의 품질과 실용성을 보장합니다. 이 스킬은 새로운 스킬 생성, 기존 스킬 리팩토링, 스킬 평가, 패키지 계획 수립 등 다양한 작업을 지원하며, 각 작업 유형에 맞는 구체적인 지침과 템플릿을 제공합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add KimYx0207/meta-skill-creator

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

메타 스킬 생성기

이 스킬을 사용하여 반복 가능한 워크플로우를 실행 가능하고, 검증 가능하며, 이식 가능한 스킬 패키지로 만드세요. 결과물은 '더 긴 프롬프트'가 아니라, 기본 진입점은 가볍고 세부 사항은 필요에 따라 로드되며 검증 방법을 재현할 수 있는 능력 패키지입니다.

핵심 계약

  • 사용자의 실제 워크플로우에서 출발하며, 개인적인 선호 템플릿에서 출발하지 않습니다.
  • 파일을 작성하기 전에 먼저 이 작업을 스킬로 만들 가치가 있음을 입증하세요. 일회성 작업을 억지로 스킬 패키지로 만들지 마십시오.
  • SKILL.md에는 라우팅 인터페이스만 유지합니다: 트리거, 첫 번째 동작, 점진적 로드, 하드 스톱, 검증.
  • 상세 연구, 제품 설계, 패키지 계획, 트리거 평가, 승인 방법 및 템플릿은 references/, assets/, evals/, scripts/에 배치합니다.
  • 모호한 의도를 보완하거나, 사용자가 여러 번 선택하게 하거나, MVP를 먼저 고정한 후 일괄 생성해야 하는 스킬은 반드시 Codex request_user_input / Claude Code AskUserQuestion 등 호스트 네이티브 의사 결정 표면을 설계해야 합니다. 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/는 검증, 변환 또는 패키징 시에만 실행하며, 스크립트 내용을 대화 컨텍스트에 붙여넣지 마십시오.

워크플로우

  1. 분류: new-skill, refactor-skill, evaluate-skill, package-plan, 또는 not-a-skill인지 판단합니다.
  2. 가져오기 및 연구: 패키지 결정, 결과물 표면, 도구 경로 또는 승인 기준을 변경할 증거만 수집합니다.
  3. 설계: 결과, 트리거 경계, 입력/출력, 로컬 기능 경로, 대화형 의사 결정 표면, MVP 고정 게이트, 패키지 구조 및 공개 실패 패턴을 결정합니다.
  4. 구축: 현재 목표를 위해 반드시 건드려야 하는 최소 파일 세트만 생성하거나 수정합니다.
  5. 검증: 패키지 검증, 폐쇄 루프 검증 및 도메인 검증을 실행합니다. 구조 증거, 결과물 증거, 실행 증거 및 수동 확인이 각각 무엇을 입증하는지 보고합니다.
  6. 폐쇄 루프: 실행 기록을 작성합니다. 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 .

생성된 패키지에 자체 스크립트가 있으면 실제 결과물에 대해서도 실행합니다. 검증 시 구조 검사, 생성된 결과물 증거, 실행/도구 증거 및 수동 승인을 명확히 구분해야 합니다. 한 수준의 통과가 전체 통과를 대체할 수 없습니다.

최종 보고서

한국어로 보고합니다: 변경된 파일, 패키지 결정, 트리거 경계, 점진적 로드 다이어그램, 검증 명령어, 증거 수준, 폐쇄 루프 결정 및 잔여 위험. 사용자가 이 스킬 패키지가 실제로 사용하기 더 쉬운지 판단할 수 있도록 작은 전후 비교 또는 출력 조각을 제공합니다.

관련 스킬