skill builder

Engineering Community

Skill notes

개요

harness 오픈소스의 6-Phase 스킬 생성 워크플로우를 MoAI cowork-plugins 컨텍스트에 맞게 변환한 스킬입니다. 수작업 스킬 작성의 품질 편차를 줄이고, 체계적인 생성 프로세스를 통해 일관된 품질의 스킬을 생산합니다. 이름 이력: v1.3.x까지 skill-forge로 제공되던 스킬이 v1.5.x에서 skill-builder로 이름 변경되었습니다. 별칭은 유지되지 않으며 모든 참조는 skill-builder로 갱신해야 합니다.

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

사용자의 자연어 요청에서 스킬 요구사항을 추출합니다. 필수 수집 항목: 항목 · 질문 · 예시 목적 · "이 스킬이 해결할 문제는?" · "영업 제안서를 자동 생성하고 싶다" 타겟 플러그인 · "어느 플러그인에 배치할까?" · moai-business

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

스킬 도메인의 공식 자료·표준 양식·베스트 프랙티스를 조사하여 SKILL.md의 정확성과 권위를 확보합니다. 조사 트리거 (다음 중 하나라도 해당하면 Phase 1.5 의무): 한국 법규·표준 양식 관련 (세무·노무·계약·채용·의료 등) 외부 라이브러리·SDK·API·CLI 활용 글로벌 베스트 프랙티스 인용이 필요한 도메인 (B2B SaaS·HR·BI·DevOps 등)

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

6개 에이전트 패턴 중 최적 패턴을 선택합니다. 패턴 · 적용 시나리오 · 스킬 예시 Pipeline · 순차 처리, 각 단계 출력이 다음 입력 · docx-generator, blog Fan-out/Fan-in · 병렬 분석 후 결과 통합 · ux-designer, market-analysis Expert Pool · 다 도메인 전문 지식 결합 · consulting-brief, startup-launchpad

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

skill-template 템플릿을 기반으로 SKILL.md 초안을 생성합니다. 필수 적용: skill-template의 필수 섹션 구조 사용 Frontmatter는 name, description만 포함 (metadata 금지) 트리거 키워드는 기존 73개 스킬과 중복되지 않도록 검사

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
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
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@modu-ai · no license declared
Token usage
Lean
Setup complexity
Plug-and-play
External API key
Not required
Operating systems
Unspecified (assume cross-platform)
Runtime requirements
No explicit requirements detected
Detected file/system behavior
  • Read-only
Network behavior
Local-only
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

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

사용자의 자연어 요청에서 스킬 요구사항을 추출합니다. 필수 수집 항목: 항목 · 질문 · 예시 목적 · "이 스킬이 해결할 문제는?" · "영업 제안서를 자동 생성하고 싶다" 타겟 플러그인 · "어느 플러그인에 배치할까?" · moai-business

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

스킬 도메인의 공식 자료·표준 양식·베스트 프랙티스를 조사하여 SKILL.md의 정확성과 권위를 확보합니다. 조사 트리거 (다음 중 하나라도 해당하면 Phase 1.5 의무): 한국 법규·표준 양식 관련 (세무·노무·계약·채용·의료 등) 외부 라이브러리·SDK·API·CLI 활용 글로벌 베스트 프랙티스 인용이 필요한 도메인 (B2B SaaS·HR·BI·DevOps 등)

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

6개 에이전트 패턴 중 최적 패턴을 선택합니다. 패턴 · 적용 시나리오 · 스킬 예시 Pipeline · 순차 처리, 각 단계 출력이 다음 입력 · docx-generator, blog Fan-out/Fan-in · 병렬 분석 후 결과 통합 · ux-designer, market-analysis Expert Pool · 다 도메인 전문 지식 결합 · consulting-brief, startup-launchpad

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

`skill-template` 템플릿을 기반으로 SKILL.md 초안을 생성합니다. 필수 적용: skill-template의 필수 섹션 구조 사용 Frontmatter는 `name`, `description`만 포함 (metadata 금지) 트리거 키워드는 기존 73개 스킬과 중복되지 않도록 검사

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

스킬 검증용 테스트 케이스를 생성합니다. 테스트 구성: 출력물: `<skill-dir>/tests/test-cases.yaml`

06
Phase 5: Validation (품질 검증)

4차원 루브릭으로 스킬을 평가합니다. 차원 · 가중치 · 평가 Correctness · 30% · 목적 달성 여부 Completeness · 25% · 에지 케이스 커버 Clarity · 25% · 사용자 이해 가능성

07
Phase 6: Review (최종 검토)

배포 전 최종 체크리스트를 실행합니다. 체크리스트: [ ] Frontmatter 형식 준수 (name, description만, metadata 없음) [ ] 필수 섹션 모두 존재 (개요, 트리거, 워크플로우, 예시, 출력, 주의사항, 관련 스킬) [ ] 트리거 키워드가 기존 스킬과 중복되지 않음

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.