skill-builder

Name: skill-builder
Author: modu-ai

Engineering Community

Repo stars 209
Author repo cowork-plugins

Interpretation is structured for decision-making; original keeps the upstream SKILL.md unchanged.

Decide Fit First

Core job: | harness 오픈소스의 6-Phase 스킬 생성 워크플로우를 MoAI cowork-plugins 컨텍스트에 맞게 변환한 스킬입니다. 수작업 스킬 작성의 품질 편차를 줄이고, 체계적인 생성 프로세스를 통해 일관된 품질의 스킬을…
Best fit: Use it when the task has reusable inputs, steps, and validation criteria rather than a one-off answer.
Avoid forcing it: If the source lacks commands, platform support, or external-service evidence, keep those fields unknown instead of guessing.

Design Intent

Structure: The skill is organized around “개요”, “트리거 키워드”, “워크플로우”, “실행 규칙”, showing how the author expects the agent to judge fit, collect context, and produce verifiable output.
Trigger evidence: Prioritize the author’s wording around when to use it, what context to collect, and what output shape to produce.
Evidence boundary: Author text states facts, repository files prove commands and paths, and Fluxly only adds fit, limits, and usage judgment.

How To Use It

Inputs: Provide target material, scope, expected result, forbidden changes, and validation method.
Invocation: Name skill-builder directly; if the source includes slash commands, start with the command and then add task context.
Validation: Start small and check whether the result follows “개요 / 트리거 키워드 / 워크플로우” before expanding.

Boundaries And Review

Dependencies: It usually needs no extra API key, so start with a small validation task.
Permissions: Declared permissions include read; ask the agent to state file, command, and rollback boundaries before acting.
Quality bar: A useful result names the deliverable, evidence, and next action. Generic prose means the task needs tighter context.

Skill Builder — 6-Phase 스킬 생성 워크플로우

moai-core | revfactory/harness 방법론 기반 스킬 생성

개요

harness 오픈소스의 6-Phase 스킬 생성 워크플로우를 MoAI cowork-plugins 컨텍스트에 맞게 변환한 스킬입니다. 수작업 스킬 작성의 품질 편차를 줄이고, 체계적인 생성 프로세스를 통해 일관된 품질의 스킬을 생산합니다.

이름 이력: v1.3.x까지 skill-forge로 제공되던 스킬이 v1.5.x에서 skill-builder로 이름 변경되었습니다. 별칭은 유지되지 않으며 모든 참조는 skill-builder로 갱신해야 합니다.

트리거 키워드

스킬 생성 스킬 제작 skill-builder 새 스킬 만들기 스킬 추가 신규 스킬 harness 워크플로우

워크플로우

Phase 1: Requirements   → 사용자 의도 분석, 트리거 키워드 정의
Phase 1.5: Research     → 공식 자료·베스트 프랙티스 외부 조사 (WebSearch + Context7)  ★ v1.6.0
Phase 2: Architecture   → 에이전트 패턴 선택 (6종 중 매핑)
Phase 3: Skill Draft    → skill-template 기반 SKILL.md 초안 + ## 출처 섹션
Phase 4: Test Gen       → 테스트 프롬프트 2-3개 + 기대 출력 정의
Phase 5: Validation     → 4차원 루브릭 스코어링 (skill-tester 본문 §스코어링 루브릭)
Phase 6: Review         → 품질 게이트 통과 확인, 파일 배치

실행 규칙

Phase 1: Requirements (요구사항 분석)

사용자의 자연어 요청에서 스킬 요구사항을 추출합니다.

필수 수집 항목:

항목	질문	예시
목적	"이 스킬이 해결할 문제는?"	"영업 제안서를 자동 생성하고 싶다"
타겟 플러그인	"어느 플러그인에 배치할까?"	moai-business
입력	"사용자가 무엇을 입력하나?"	회사명, 타겟 산업, 제품 정보
출력	"어떤 산출물을 기대하나?"	제안서 DOCX 파일
복잡도	"스킬이 얼마나 복잡한가?"	Standard (50-150줄)

출력물: 요구사항 문서 (인메모리, AskUserQuestion으로 확인)

Phase 1.5: Research (외부 자료 조사) ★ v1.6.0 신설

스킬 도메인의 공식 자료·표준 양식·베스트 프랙티스를 조사하여 SKILL.md의 정확성과 권위를 확보합니다.

조사 트리거 (다음 중 하나라도 해당하면 Phase 1.5 의무):

한국 법규·표준 양식 관련 (세무·노무·계약·채용·의료 등)
외부 라이브러리·SDK·API·CLI 활용
글로벌 베스트 프랙티스 인용이 필요한 도메인 (B2B SaaS·HR·BI·DevOps 등)
정량 수치·통계 데이터·시장 규모 인용

조사 절차:

WebSearch 2-4회 (병렬 권장)
- 한국어 쿼리 1-2회: "<도메인> <핵심 키워드> <연도>" 형식 (예: "한국 채용절차법 NCS 2026")
- 영어 쿼리 1-2회 (글로벌 베스트 프랙티스 인용 시): "<topic> best practice <year>" 형식
- 검색 결과의 최신성 확인 (2년 이내 자료 우선)
Context7 MCP (라이브러리·SDK·CLI 관련 스킬일 때)
- resolve-library-id → get-library-docs 순서
- 최신 API/CLI 변경사항·deprecation 확인
- 학습 데이터 cutoff 보완

도메인별 공식 출처 화이트리스트 (우선 인용):

도메인	1차 권장 출처
한국 세무·재무	국세청 nts.go.kr, 홈택스 hometax.go.kr, DART dart.fss.or.kr
한국 노무·채용	고용노동부 moel.go.kr, NCS ncs.go.kr, 한국노동연구원 kli.re.kr
한국 의료·건강	식약처 mfds.go.kr, 보건복지부 mohw.go.kr, 건강보험공단 nhis.or.kr
한국 정부지원	K-Startup k-startup.go.kr, BIZINFO bizinfo.go.kr
한국 통계·시장	KOSIS kosis.kr, 한국은행 ECOS ecos.bok.or.kr
한국 법률	국가법령정보센터 law.go.kr, 대법원 종합법률정보 glaw.scourt.go.kr
글로벌 회계 표준	K-IFRS, IFRS Foundation ifrs.org
글로벌 채용 규제	EEOC eeoc.gov, NYC Local Law 144, ISO 42001:2023
글로벌 SaaS BP	제품 공식 문서(HubSpot·Salesforce·Greenhouse 등) + 업계 리딩 블로그

출처 보존:
- 조사 결과의 URL·발행일·핵심 인용 문장을 인메모리에 보존
- Phase 3에서 SKILL.md ## 출처 섹션에 markdown hyperlink 형식으로 인용
- 정량 수치는 출처 인라인 표기 또는 [추정] 태그 강제

산출물: research notes (인메모리, Phase 3 입력으로 전달)

금지:

출처 없는 정량 수치 인용 (반드시 출처 명시 또는 [추정] 태그)
한국 도메인 스킬에 한국 공식 출처 누락
라이브러리·SDK 관련 스킬에 Context7 MCP 미사용 (가용 시)
구버전 자료 인용 (3년 초과 시 최신 자료 재검색)

스킵 조건 (Phase 1.5 생략 가능):

단순 포맷 변환·텍스트 처리 스킬 (도메인 지식 불필요)
사용자가 명시적으로 --skip-research 플래그 지정
기존 cowork 스킬의 minor 개선·트리거 키워드 조정만

Phase 2: Architecture (아키텍처 선택)

6개 에이전트 패턴 중 최적 패턴을 선택합니다.

패턴	적용 시나리오	스킬 예시
Pipeline	순차 처리, 각 단계 출력이 다음 입력	docx-generator, blog
Fan-out/Fan-in	병렬 분석 후 결과 통합	ux-designer, market-analysis
Expert Pool	다 도메인 전문 지식 결합	consulting-brief, startup-launchpad
Producer-Reviewer	생성 + 품질 검토 순환	sales-playbook, copywriting
Supervisor	다수 전문 스킬 오케스트레이션	ai-diagnostic, project
Hierarchical Delegation	복잡 작업 계층적 분해	startup-launchpad

선택 기준: 스킬의 워크플로우 단계 수, 병렬성 여부, 품질 검증 필요성을 기준으로 판단합니다.

출력물: 선택된 패턴 + 근거 (1-2문장)

Phase 3: Skill Draft (스킬 초안 생성)

skill-template 템플릿을 기반으로 SKILL.md 초안을 생성합니다.

필수 적용:

skill-template의 필수 섹션 구조 사용
Frontmatter는 name, description만 포함 (metadata 금지)
트리거 키워드는 기존 73개 스킬과 중복되지 않도록 검사
사용 예시 최소 2개 포함
관련 스킬 섹션에 before/after/alternative 관계 명시
## 출처 섹션 의무: Phase 1.5에서 수집한 URL·인용을 markdown hyperlink로 명시 (Phase 1.5 적용 스킬)
정량 수치 인용 규칙: 모든 수치는 출처 인라인 표기 또는 [추정] 태그

참조: moai-core/skills/skill-tester/SKILL.md §스코어링 루브릭 (품질 기준 single source) 참조: moai-core/skills/skill-template/SKILL.md (템플릿)

출력물: <target-plugin>/skills/<skill-name>/SKILL.md 초안

Phase 4: Test Generation (테스트 생성)

스킬 검증용 테스트 케이스를 생성합니다.

테스트 구성:

tests:
  - name: "happy-path"
    prompt: "<대표적인 사용 프롬프트>"
    expected_output:
      format: "<출력 형식>"
      contains: ["<필수 포함 내용>"]
      not_contains: ["<금지 내용>"]

  - name: "edge-case"
    prompt: "<경계 조건 프롬프트>"
    expected_output:
      handles_gracefully: true
      fallback_behavior: "<설명>"

  - name: "complex-input"
    prompt: "<복잡한 입력 프롬프트>"
    expected_output:
      completeness: "모든 요구사항 충족"

출력물: <skill-dir>/tests/test-cases.yaml

Phase 5: Validation (품질 검증)

4차원 루브릭으로 스킬을 평가합니다.

차원	가중치	평가
Correctness	30%	목적 달성 여부
Completeness	25%	에지 케이스 커버
Clarity	25%	사용자 이해 가능성
Efficiency	20%	토큰 대비 품질

통과 기준: 가중 평균 >= 0.70, 모든 차원 >= 0.50

미달 시: Phase 3으로 돌아가서 부족한 차원을 보완합니다. 최대 3회 반복.

참조: moai-core/skills/skill-tester/SKILL.md §스코어링 루브릭 (anchor 점수표 + 평가 절차)

Phase 6: Review (최종 검토)

배포 전 최종 체크리스트를 실행합니다.

체크리스트:

Frontmatter 형식 준수 (name, description만, metadata 없음)
필수 섹션 모두 존재 (개요, 트리거, 워크플로우, 예시, 출력, 주의사항, 관련 스킬)
트리거 키워드가 기존 스킬과 중복되지 않음
plugin.json 버전이 업데이트 필요한 경우 안내
스킬 체인 관계가 CLAUDE.local.md §3-3과 일치 (해당 시)
테스트 케이스가 생성됨
루브릭 스코어 0.70 이상 통과
## 출처 섹션 존재 (Phase 1.5 적용 스킬, --skip-research 미지정 시)
정량 수치 모두 출처 또는 [추정] 태그 (Phase 1.5 적용 스킬)

배치: <target-plugin>/skills/<skill-name>/SKILL.md 에 최종 파일을 배치합니다.

사용 예시

예시 1: 신규 스킬 생성

"moai-business에 영업 제안서 자동 생성 스킬을 만들어줘. 회사명과 타겟 기업 입력하면 제안서 DOCX가 나오게"

예시 2: Vibe 갭 스킬 생성

"skill-builder로 moai-product에 UX 디자인 분석 스킬을 만들어줘. Vibe Designing 기능 참고해서"

출력 형식

산출물	위치	설명
SKILL.md	`<plugin>/skills/<name>/SKILL.md`	완성된 스킬 정의
test-cases.yaml	`<plugin>/skills/<name>/tests/`	테스트 케이스
score-report	인메모리	루브릭 스코어 보고서

주의사항

기존 스킬 수정이 아닌 신규 스킬 생성에만 사용합니다
플러그인 디렉토리(moai-*)가 존재하는지 사전 확인이 필요합니다
스킬 생성 후 plugin.json 버전 bump는 릴리스 절차(CLAUDE.local.md §1)에서 일괄 처리합니다
트리거 키워드 중복 시 기존 스킬의 description을 확인하여 명확히 구분해야 합니다

Changelog

1.6.0 (2026-05-01): Phase 1.5 Research 신설 — 외부 자료 조사(WebSearch·Context7) 의무화, 도메인별 공식 출처 화이트리스트 추가, ## 출처 섹션 의무화 + 정량 수치 출처/[추정] 태그 강제
1.5.x: skill-forge → skill-builder 이름 변경
이전: harness 6-Phase 워크플로우 흡수

Fluxly profile Author and license come from source; runtime, permissions, and network are Fluxly detections or estimates

Fluxly category: Engineering
Author-declared agents: No explicit declaration found; this is not inferred or tested compatibility
Static check: 88 / 100 · heuristic scan, not runtime safety proof
Author / version / license: @modu-ai · no license declared
Fluxly token estimate: Lean
Fluxly setup estimate: Plug-and-play
External API key: No requirement detected
Detected OS requirements: Unspecified
Runtime requirements: Unspecified
Detected file/system behavior: Read-only
Detected network behavior: Local-only
Install commands: None (reference only)

Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.

Heads up: 未限定 allowed-tools，默认拥有全部工具权限。

Output preview skill-builder-modu-ai.preview

The current SKILL.md does not define a fixed output example.

SKILL.md SKILL.md

# Skill Builder — 6-Phase 스킬 생성 워크플로우

> moai-core | revfactory/harness 방법론 기반 스킬 생성

## 개요

harness 오픈소스의 6-Phase 스킬 생성 워크플로우를 MoAI cowork-plugins 컨텍스트에 맞게 변환한 스킬입니다. 수작업 스킬 작성의 품질 편차를 줄이고, 체계적인 생성 프로세스를 통해 일관된 품질의 스킬을 생산합니다.

> **이름 이력**: v1.3.x까지 `skill-forge`로 제공되던 스킬이 v1.5.x에서 `skill-builder`로 이름 변경되었습니다. 별칭은 유지되지 않으며 모든 참조는 `skill-builder`로 갱신해야 합니다.

## 트리거 키워드

스킬 생성 스킬 제작 skill-builder 새 스킬 만들기 스킬 추가 신규 스킬 harness 워크플로우

## 워크플로우

```
Phase 1: Requirements   → 사용자 의도 분석, 트리거 키워드 정의
Phase 1.5: Research     → 공식 자료·베스트 프랙티스 외부 조사 (WebSearch + Context7)  ★ v1.6.0
Phase 2: Architecture   → 에이전트 패턴 선택 (6종 중 매핑)
Phase 3: Skill Draft    → skill-template 기반 SKILL.md 초안 + ## 출처 섹션
Phase 4: Test Gen       → 테스트 프롬프트 2-3개 + 기대 출력 정의
Phase 5: Validation     → 4차원 루브릭 스코어링 (skill-tester 본문 §스코어링 루브릭)
Phase 6: Review         → 품질 게이트 통과 확인, 파일 배치
```

## 실행 규칙

### Phase 1: Requirements (요구사항 분석)

사용자의 자연어 요청에서 스킬 요구사항을 추출합니다.

**필수 수집 항목:**

| 항목 | 질문 | 예시 |
|------|------|------|
| 목적 | "이 스킬이 해결할 문제는?" | "영업 제안서를 자동 생성하고 싶다" |
| 타겟 플러그인 | "어느 플러그인에 배치할까?" | moai-business |
| 입력 | "사용자가 무엇을 입력하나?" | 회사명, 타겟 산업, 제품 정보 |
| 출력 | "어떤 산출물을 기대하나?" | 제안서 DOCX 파일 |
| 복잡도 | "스킬이 얼마나 복잡한가?" | Standard (50-150줄) |

**출력물:** 요구사항 문서 (인메모리, AskUserQuestion으로 확인)

### Phase 1.5: Research (외부 자료 조사) ★ v1.6.0 신설

스킬 도메인의 공식 자료·표준 양식·베스트 프랙티스를 조사하여 SKILL.md의 정확성과 권위를 확보합니다.

**조사 트리거 (다음 중 하나라도 해당하면 Phase 1.5 의무):**

- 한국 법규·표준 양식 관련 (세무·노무·계약·채용·의료 등)
- 외부 라이브러리·SDK·API·CLI 활용
- 글로벌 베스트 프랙티스 인용이 필요한 도메인 (B2B SaaS·HR·BI·DevOps 등)
- 정량 수치·통계 데이터·시장 규모 인용

**조사 절차:**

1. **WebSearch 2-4회 (병렬 권장)**
   - 한국어 쿼리 1-2회: `"<도메인> <핵심 키워드> <연도>"` 형식 (예: "한국 채용절차법 NCS 2026")
   - 영어 쿼리 1-2회 (글로벌 베스트 프랙티스 인용 시): `"<topic> best practice <year>"` 형식
   - 검색 결과의 최신성 확인 (2년 이내 자료 우선)

…

Evidence boundary and execution chain

Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.

sections -> 개요 → 트리거 키워드 → 워크플로우 → 실행 규칙 → Phase 1: Requirements (요구사항 분석) → Phase 1.5: Research (외부 자료 조사) ★ v1.6.0 신설
terms    -> 이름 이력 · 필수 수집 항목 · 출력물 · 조사 트리거 (다음 중 하나라도 해당하면 Phase 1.5 의무) · 조사 절차 · WebSearch 2-4회 (병렬 권장) · Context7 MCP (라이브러리·SDK·CLI 관련 스킬일 때) · 도메인별 공식 출처 화이트리스트 (우선 인용)
files/cmd -> skill-forge · skill-builder · "<도메인> <핵심 키워드> <연도>" · "<topic> best practice <year>" · resolve-library-id · get-library-docs · ## 출처 · [추정]
body sha256 -> 340dd712e136