Community생산성 & 협업github.com

nova-skill-creator

사용자가 새로운 스킬을 작성하거나, 스킬을 생성/빌드/업그레이드/수정/검토할 때 사용합니다. Claude, Grok 또는 다른 LLM을 위한 스킬, SKILL.md, SOP, 가상 직원 또는 스킬 엔지니어에 대해 사용자가 언급할 때마다 활성화됩니다.

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

Nova Skill Creator는 AI 에이전트 스킬(예: Claude Code, Cursor, Codex)을 작성, 업그레이드, 수정 및 검토하기 위한 메타 스킬입니다. 이 스킬은 사용자의 요청을 표준 엔지니어링 프로세스로 변환하여, 단일 SKILL.md 파일 또는 폴더 구조로 된 배포 가능한 전문 스킬을 생성합니다. 이 프로세스는 'Skill Engineer Protocol v2.2'를 따르며, 복잡성에 따라 Sequential Workflow 패턴과 적절한 스킬 유형(예: Code Scaffolding & Templates)을 선택합니다. 주요 기능으로는 콘텐츠 손실을 방지하는 '최상위 규칙(SUPREME RULE)' 준수, 14개 항목의 체크리스트 기반 품질 게이트, 점진적 공개(Progressive Disclosure)를 통한 효율적인 컨텍스트 관리, 그리고 정확한 활성화를 위한 설명 작성 프로토콜(Description Protocol)이 있습니다. 이 스킬은 다양한 대상 환경(claude.ai 계정, Grok, Claude Code, Codex)을 지원하며, 각 환경에 맞게 YAML 프론트매터를 조정해야 합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/chuong1224/nova-skill-creator/tree/HEAD/skills/nova-skill-creator

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

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

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

문서

Nova Skill Creator — Skill Engineer Protocol v2.2

버전 2.4.1 · 패턴: Sequential Workflow · 유형: Code Scaffolding & Templates

"Skill Engineer Protocol v2.2"는 이 스킬이 따르는 프로세스의 이름이며, 릴리스 번호가 아닙니다.

목적

이 메타 스킬은 스킬 관련 모든 요청(새로 작성/업그레이드/수정/검토)을 표준 엔지니어링 프로세스로 전환하고, 즉시 배포 가능한 전문 스킬을 생성합니다. 각 출력 스킬은 독립적인 "가상 직원"으로, 복잡성과 대상 환경에 따라 1개의 SKILL.md 파일 또는 1개의 전체 폴더 형태입니다.

이 스킬이 활성화되면, 정확히 다음 문장으로 응답을 시작하세요: "Skill Engineer Protocol v2.2 activated. Starting the standard process..."

해당 문장 이후에는 사용자가 작성하는 언어로 응답하세요.


⚠️ 다시 작성할 때 콘텐츠 보존 (최상위 규칙)

"전체 다시 쓰기"는 재구조화를 의미하며, 압축/요약을 의미하지 않습니다. 이 스킬이 다른 LLM(특히 약한 모델)과 함께 적용될 때 가장 흔한 실패는 기술적 설명이 압축되고, 테이블 열이 잘리며, 구체적인 스키마/값이 누락되는 것입니다. 출력이 더 깔끔해 보이지만 원본 콘텐츠가 손실됩니다.

필수 구분:

재구조화 (올바름)압축 (틀림)
레이아웃 변경, 중복 섹션 병합, 문구 수정테이블, 행, 열, 예제 삭제
모든 값/스키마/ID/규칙을 정확히 유지스키마를 "대략"으로 의역
출력 항목 수 >= 입력 항목 수10개의 주의사항을 4개로 축소
명확성 향상"더 짧게 만들기 위해" 세부 사항 축소

3단계 압축 방지 프로세스 — 다시 쓰기 또는 업그레이드 전후에 반드시 수행:

  1. 먼저 인벤토리 작성 (콘텐츠 인벤토리): 손실되어서는 안 되는 모든 원본 요소를 나열 — 각 테이블(행/열 수 포함), 각 스키마 규칙, 각 구체적인 값(ID, 버전, 옵션), 각 주의사항, 각 테스트 케이스. 체크리스트로 기록하세요.
  2. 제약 조건 하에서 다시 쓰기: 다시 쓰는 동안 목록의 모든 요소가 출력에 완전히 나타나야 합니다. 표현을 개선할 수는 있지만, 요소 수나 각 요소의 세부 사항을 줄일 수는 없습니다.
  3. 이후 확인 (차이점 검사): 출력을 인벤토리와 비교합니다. 요소가 누락되었거나 테이블의 행/열이 원본보다 적은 경우 → 완료되지 않음; 답변하기 전에 복원하세요.

실행 LLM을 위한 자체 바인딩 지침: "모든 테이블, 스키마, 구체적인 값 및 주의사항을 그대로 보존하세요. 요약하지 말고, 기술적 세부 사항을 삭제하지 마세요. 더 짧아야 한다면 references/로 분할하고 콘텐츠를 절대 삭제하지 마세요."


스킬은 폴더입니다 — 복잡성에 따라 구조를 선택하세요

Claude, Claude Code 및 기타 에이전트는 SKILL.md + 번들 리소스가 포함된 폴더로서의 스킬을 지원하며, 점진적 공개(필요 시 리소스 로드), 오프라인 실행 가능 스크립트, 동적으로 로드되는 references/를 제공합니다. 모든 것을 하나의 파일에 우겨넣을 필요가 없습니다.

복잡성권장 구조
단순하고 짧은 스킬SKILL.md 파일 1개만 (여전히 유효)
반복적/결정적 로직이 있는 스킬폴더 + scripts/
다중 도메인 스킬 / 긴 문서폴더 + 변형별로 분할된 references/
번들 파일(템플릿/아이콘/폰트)을 출력하는 스킬폴더 + assets/

원칙: 충분한 가장 작은 구조를 선택하세요. 단순 → 파일 1개; 복잡 → 폴더로 분할하여 SKILL.md를 간결하게 유지하세요. 콘텐츠가 너무 길면 → references/로 분할하고 압축하지 마세요.


스킬의 구성

skill-name-kebab-case/
├── SKILL.md          (필수)
│   ├── YAML 프론트매터 (계정/자유 형식 LLM용 5개 필드 · 표준 에이전트 스킬 대상의 경우 name + description만 — '대상 환경별 변형' 참조)
│   └── 마크다운 지침
└── 번들 리소스 (선택 사항)
    ├── scripts/      - 결정적/반복적 작업을 위한 실행 가능한 코드
    ├── references/   - 필요할 때 컨텍스트에 로드되는 문서
    └── assets/       - 출력에 사용되는 파일 (템플릿, 아이콘, 폰트)

점진적 공개 (3가지 로딩 레벨)

레벨콘텐츠컨텍스트에 진입하는 시점
1메타데이터 (name + description)항상 (~100 단어)
2SKILL.md 본문스킬이 활성화될 때 (이상적으로 500줄 미만)
3번들 리소스필요할 때 (references/는 동적으로 로드; scripts/는 컨텍스트에 콘텐츠를 로드하지 않고 실행)

규칙: SKILL.md 본문을 500줄 미만으로 유지하세요. 한도에 도달하면 → references/로 분할하고 SKILL.md에 읽을 위치를 명확하게 표시하세요. 긴 참조문서(>300줄)는 목차가 있어야 합니다. 분할은 압축과 다릅니다 — 분할은 콘텐츠를 다른 파일에 그대로 유지하고, 압축은 콘텐츠를 손실합니다.


새 스킬 작성 프로세스 (8단계)

#단계설명
1누락된 정보 요청목표, 주의사항, 언어, 출력, 대상 환경. 대화에 이미 워크플로가 포함된 경우 먼저 내역에서 추출하고 누락된 것만 요청
2패턴 1개 + 스킬 유형 1개 선택각각 정확히 1개 (아래 목록 참조)
3설명을 먼저 작성가장 중요한 단계 — 아래 설명 프로토콜을 따름
4구조 선택 + 콘텐츠 설계단일 파일 또는 폴더? 인라인으로 유지할 것, references/로 보낼 것, 어떤 로직을 scripts/로 만들 것인가
5SKILL.md 작성YAML + 워크플로 + 규칙/스키마 + 주의사항; 본문 500줄 미만, 긴 부분은 references로 오프로드
6필요시 스크립트/참조문서 작성결정적/반복적 로직 → scripts/; 긴 문서 → 포인터와 함께 references/
7활성화 테스트긍정 사례 3개 + 부정 사례 3개
8출력 형식을 사용하여 답변아래 출력 형식 섹션 참조

14/14 체크리스트 항목이 모두 통과된 경우에만 릴리스하세요.


업그레이드 / 수정 프로세스 (8단계)

  1. 현재 SKILL.md(및 번들 파일) 전체를 읽습니다.
  2. 먼저 인벤토리 작성 — 손실되어서는 안 되는 모든 테이블/스키마/값/주의사항/테스트 사례를 나열합니다(최상위 규칙, 1단계).
  3. 사용자 및 이전 실행의 주의사항을 기록합니다.
  4. 14개 항목 체크리스트에 대해 평가합니다.
  5. 실패 유형 식별: 과소 트리거 / 과다 트리거 / 실행 오류 / 콘텐츠 손실(압축/잘림).
  6. 보존 제약 조건 하에서 모든 것을 다시 작성 — 재구조화, 압축하지 마십시오. 절대 조각별로 패치하지 마십시오.
  7. 이후 확인 — 출력을 인벤토리와 비교하고 누락된 항목을 복원합니다.
  8. 긍정 3개 + 부정 3개 사례를 다시 테스트하고 version을 올립니다.

철칙: 전체 다시 쓰기 = 모든 콘텐츠를 유지하는 재구조화. 패치워크 금지. 세부 사항 압축 금지. 업그레이드 시 이전 name을 유지합니다.


YAML 프론트매터 (필수)

---
name: skill-name-kebab-case
version: x.x.x
description: >-
  [활성화에 최적화된 설명, 1024자 미만, 분음 부호 없음, 꺾쇠 괄호 없음]
pattern: [5개 패턴 중 1개]
type: [9개 스킬 유형 중 1개]
---

대상 환경별 변형 (프론트매터를 작성하기 전에 물어보세요)

위의 5개 필드 블록은 claude.ai 계정 / Grok / 자유 형식 LLM용 템플릿입니다. 일부 대상은 정확히 2개의 필드만 허용합니다. 해당 대상에 5개 필드 버전을 제출하면 검토가 시작되기도 전에 즉시 유효성 검사에 실패합니다. 1단계(수집)에서 대상을 반드시 묻거나 추론해야 합니다. 명확하지 않은 경우 2개 필드 버전을 기본값으로 사용하세요. 2개 필드 버전은 모든 대상에서 작동하지만 5개 필드 버전은 그렇지 않기 때문입니다.

대상프론트매터Version / Pattern / Type 위치
claude.ai 계정, Grok, 기타 LLM위 템플릿과 같은 5개 필드, description은 >-로 접힘YAML 내부
표준 에이전트 스킬 (Claude Code .claude/skills, Codex .agents/skills) 및 엄격한 유효성 검사가 있는 스킬 레지스트리name + description만, 각각 한 줄 — >- 없음, 들여쓰기된 줄 없음, 세 번째 필드 없음H1 바로 아래 한 줄 인용: > **Version x.y.z** · Pattern: … · Type: …; 실제 버전은 대상 시스템의 레지스트리/매니페스트 파일(있는 경우)에 위치

에이전트 스킬 대상용 템플릿:

---
name: skill-name-kebab-case
description: "[활성화에 최적화된 설명, 한 줄, >= 40자, 분음 부호 없음, 꺾쇠 괄호 없음]"
---

한 줄 description은 항상 큰따옴표로 묶으세요. Claude Code와 Codex는 실제 YAML 파서로 프론트매터를 읽습니다. 값만 있는 경우 두 가지 종류의 문제가 발생할 수 있습니다. (1) 구문 분석 오류 — 스킬이 빈 메타데이터와 경고 없이 로드됨: 중간에 : 가 있는 경우(예: Vi du: … 또는 Example: …), 끝에 :가 있는 경우, [ { > | ' " * ! % @ , 또는 백틱으로 시작하는 경우, 또는 - ? : (문자 뒤에 공백)로 시작하는 경우. (2) 의미의 자동 변경 — 구문 분석되지만 잘못됨: #로 시작하면 설명이 비어지고, 중간에 #가 있으면 나머지가 잘리고, &로 시작하면 앵커가 됩니다. 큰따옴표는 두 경우를 모두 방지합니다. 큰따옴표 안에는 " 또는 \를 사용하지 마세요.

엄격한 유효성 검사가 있는 레지스트리는 종종 다음도 차단합니다: Windows 드라이브 문자(드라이브 + 콜론 + 슬래시 — 하드 코딩 대신 <root>/… 작성)를 포함하는 절대 경로, 자격 증명처럼 보이는 문자열, 패키지 내부의 깨진 마크다운 링크, stdout/stderr를 UTF-8로 강제하지 않는 .py 스크립트. 독립 검토는 또한 claude.ai 샌드박스에서만 작동하는 구문(/mnt/skills/…, /mnt/user-data/outputs/, present_files, extract-text)을 자주 거부합니다. 호스트 중립적인 지침을 작성하세요.

5가지 패턴 (정확히 1개 선택)

Sequential Workflow | Multi-MCP Coordination | Iterative Refinement | Context-Aware Tool Selection | Domain-Specific Intelligence

9가지 스킬 유형 (정확히 1개 선택)

Library & API Reference | Product Verification | Code Scaffolding & Templates | Business Process Automation | Data Fetching & Analysis | Code Quality & Review | CI/CD & Deployment | Runbooks | Infrastructure Operations


설명 작성 프로토콜 (필수)

목표: 활성화율 72–90%.

요구사항세부 사항
트리거 구문최소 5개 구문 (사용자가 작성하는 모든 언어로, 필요시 로마자 표기, 예: 영어 + 베트남어)
스타일상황 기반: "사용자가 원할 때 사용...", "WHENEVER..."
실제 예제사용자가 실제로 입력하는 몇 가지 샘플 프롬프트
길이1024자 미만
분음 부호 없음YAML 필드만: 일반 ASCII — 모든 악센트 문자 및 성조 기호 제거 (예: 베트남어 ă â ê ô ơ ư đ). 라틴 문자로 작성되지 않은 언어의 경우 로마자 표기 또는 영어 트리거 구문 사용
꺾쇠 괄호 없음여는/닫는 꺾쇠 괄호를 절대 사용하지 마세요
부정 차단기차단 문장으로 끝내기: "다음과 같은 경우에는 사용하지 마세요..."

표준 설명 예시 (일반 ASCII):

Use when the user wants to add content to an AI Wiki on Notion, save AI knowledge,
classify article links, notes, tools, prompts. WHENEVER the user pastes a link,
a note, a tool name or an AI prompt to keep. Examples - save this link to the wiki,
add this tool to notion, keep this prompt, save this article. Do not use when the
user only asks a knowledge question or asks for new content with no intent to save.

14개 항목 체크리스트 (게이트 — 14/14 필수)

#기준통과 조건
1name이 올바른 kebab-case이고 "claude"/"anthropic"을 포함하지 않음☐
2YAML에 name + version + description (+ pattern + type)이 있음☐
3description이 설명 프로토콜을 완전히 충족함☐
4설명에 꺾쇠 괄호가 없음☐
5SKILL.md 본문이 500줄 미만 (긴 부분은 references로 오프로드)☐
6정확히 1개의 패턴 + 1개의 스킬 유형 선택됨☐
7AI가 이미 알고 있는 기초를 가르치지 않음☐
8실제 주의사항이 있음 (최소 5개)☐
9구조가 필요에 맞음: 긴 문서는 명확한 포인터와 함께 references/로 분할☐
10반복적/결정적 로직은 수동으로 설명하는 대신 scripts/로 패키징☐
11설명이 활성화에 최적화되고 부정 차단기가 있음☐
12긍정 사례 3개 + 부정 사례 3개 테스트됨☐
13업그레이드인 경우 전체 다시 작성됨 (패치 없음)☐
14차이점 검사 완료: 모든 원본 테이블/스키마/값/주의사항/테스트 사례가 여전히 완전하며 압축되거나 잘리지 않음☐

14/14가 모두 통과된 경우에만 사용자에게 답변하세요.


6가지 황금 원칙

  1. AI가 이미 알고 있는 것을 가르치지 마세요 — 특정 컨텍스트와 주의사항에만 집중하세요.
  2. 주의사항이 가장 가치 있는 자산입니다 — 반복되는 모든 실패를 기록하세요.
  3. 계속 업데이트하세요 — 모든 실수 = 새로운 주의사항 → 즉시 업그레이드.
  4. 충분한 가장 작은 구조 — 단순 = 파일 1개, 복잡 = 폴더로 분할하고 점진적 공개를 사용하세요.
  5. 전체 다시 쓰기 = 재구조화, 압축 아님 — 기술 콘텐츠를 완전히 보존하세요. 너무 길면 references로 분할하고 압축하지 마세요.
  6. 조각별로 패치하지 마세요.

사용자에게 답변할 때 출력 형식 (필수, 이 순서대로)

  1. 스킬 요약 — 목적, 패턴, 유형, 구조 (단일 파일 또는 폴더).
  2. 전체 SKILL.md 콘텐츠 — 코드 블록 내; 폴더인 경우 references/ / scripts/ / assets/ 파일도 나열.
  3. 배포 가이드 — 대상 환경에 대한 구체적인 단계.
  4. 테스트 결과 — 긍정 사례 3개 + 부정 사례 3개.
  5. 차이점 검사 — 원본 콘텐츠가 손실되지 않았는지 확인 (업그레이드/재작성인 경우).
  6. 처리된 주의사항 — 업그레이드인 경우.
  7. 버전 — YAML의 버전.

배포 가이드

폴더 스킬 (Claude Code / 에이전트 / API):

  1. skill-name-kebab-case/ 폴더를 생성합니다.
  2. 루트에 SKILL.md를 배치하고, 필요한 경우 scripts/, references/, assets/를 추가합니다.
  3. 환경이 예상하는 방식(스킬 디렉토리 폴더 또는 .skill 패키지)으로 스킬을 설치합니다.
  4. 긍정 프롬프트 1개를 트리거하여 활성화를 확인합니다.

단일 파일 스킬 (UI 에디터 / 자유 형식 LLM):

  1. 전체 SKILL.md 내용을 복사하여 대상의 스킬 편집기에 붙여넣습니다.
  2. YAML 프론트매터가 대상의 유효성 검사 규칙과 일치하는지 확인합니다 (위의 '대상 환경별 변형' 참조).
  3. 환경에 적응형 프롬프트가 있는 경우 활성화 기간을 단축하기 위해 하나의 샘플 트리거를 제공합니다.

이 스킬의 주의사항 (일반 오류)

  1. 설명이 활성화에 최적화되지 않음 — 트리거 구문 부족, 혼란스러운 표현.
  2. YAML 프론트매터가 대상에서 실패함 — 잘못된 필드 수, 꺾쇠 괄호, 분음 부호.
  3. '전체 다시 쓰기'가 콘텐츠를 압축함 — 인벤토리 + 차이점 검사를 수행하지 않음.
  4. 스킬이 AI가 이미 알고 있는 내용을 가르침 — 불필요한 컨텍스트 낭비.
  5. 스킬이 너무 김 (500줄 초과) — references/로 분할하지 않음.
  6. 점진적 공개 누락 — 모든 리소스를 SKILL.md 본문에 우겨넣음.
  7. 부정 차단기 없음 — 관련 없는 요청에서도 활성화됨.
  8. 종속성에 대한 가정 — LLM이 사용할 수 없는 도구에 액세스할 수 있다고 가정.
  9. 환경별 구문 사용 — claude.ai 샌드박스에만 해당되는 구문으로 인해 다른 대상에서 실패.
  10. 스킬 이름에 'claude'/'anthropic' 포함 — 레지스트리 차단 가능성.

변경 로그

  • v2.4.1 — 에이전트 스킬 대상에 대한 한 줄 설명 따옴표 규칙 추가; 부정 차단기 예제 추가; 14번째 체크리스트 항목(Diff Check) 명확화.
  • v2.4.0 — 부정 차단기 섹션 추가; 설명 프로토콜 강화; 대상 환경 안내 개선.
  • v2.3.0 — 점진적 공개 및 구조 선택 원칙 추가.
  • v2.2.0 — 콘텐츠 보존 최상위 규칙 도입; 새 스킬 및 업그레이드 프로세스를 8단계로 통합.
  • v2.1.0 — 14개 항목 체크리스트 추가; 6가지 황금 원칙 추가.

관련 스킬