스킬 품질 보증
OpenClaw 스킬 문서 품질을 자동으로 분석하고 점수를 매깁니다. 주요 문제를 식별하고 실행 가능한 수정 사항을 제공합니다.
개요
이 스킬은 모든 OpenClaw 스킬의 SKILL.md 파일을 다차원 품질 분석하여 다음 항목을 평가합니다:
- 명확성 — 구조, 제목, 문장 길이
- 완전성 — 필수 필드, 설치/사용법 섹션
- 실행 가능성 — 단계별 가이드, 명령어
- 검색 가능성 — 키워드, 설명, 카테고리
- 예제 — 코드 예제, 전/후 사례, 사용 사례
사용법
단일 스킬 분석
다음 스킬을 분석해: C:\path\to\skills\my-skill
디렉토리의 모든 스킬 분석
실행: node engine.js C:\path\to\skills
해석
| 점수 | 등급 | 의미 |
|---|---|---|
| 8-10 | A | 프로덕션 준비 완료 |
| 6-7 | B | 약간의 개선 필요 |
| 4-5 | C | 상당한 작업 필요 |
| <4 | F | 재작성 권장 |
평가 기준
1. 명확성 (20%)
확인 항목: 제목 계층, 문장 길이, 군더더기 단어, 마크다운 형식
2. 완전성 (20%)
확인 항목: name, description, keywords, 설치 섹션, 사용법 섹션
3. 실행 가능성 (25%)
확인 항목: 번호 매기기 단계, 실행 가능한 명령어, 구성 가이드
4. 검색 가능성 (15%)
확인 항목: 키워드(5개 이상), 설명 길이(50자 이상), 카테고리/태그
5. 예제 (20%)
확인 항목: 코드 블록(3개 이상), 전/후 사례, 사용 사례 설명
품질 임계값
ClawHub 게시 조건:
- 전체 점수 ≥ 7.0 필요
- 어떤 차원도 5.0 미만이어서는 안 됨
- 키워드 필드 필수
- 설명 길이 50자 이상 필요
자동 수정
동반 스크립트 fix_skill_md.cjs가 자동으로 수정합니다:
- 누락된
description필드 - 누락된
keywords필드 - 누락된
Install섹션 - 누락된
Usage섹션
node fix_skill_md.cjs
출력 예시
# 스킬 품질 보고서
분석된 스킬: 34개
## 전체 순위
1. ✅ skylv-browser-automation-agent 9.4/10
2. ✅ skylv-openclaw-evomap-connector 9.3/10
평균 점수: 8.1/10
A 등급(7+): 29
B 등급(5-6): 5
C 등급(<5): 0