webkong/skill-quality-check

skill-quality-check은(는) 무엇을 하나요?

AI 에이전트 스킬을 위한 품질 감사 도구. 모든 SKILL.md를 클로드 모범 사례에 따라 5차원 점수 프레임워크로 감사합니다.

개요

이 도구는 AI 에이전트 스킬(SKILL.md)의 품질을 평가합니다. 각 스킬은 5가지 핵심 차원에서 점수가 매겨집니다:

1. 명확성 - 스킬의 목적과 사용법이 명확하게 문서화되었는가?
2. 완전성 - 모든 필요한 요소(예: 입력, 출력, 오류 처리)가 포함되었는가?
3. 효율성 - 스킬이 불필요한 단계 없이 효율적으로 동작하는가?
4. 유지보수성 - 스킬이 유지보수와 업데이트가 용이한 구조인가?
5. 호환성 - 스킬이 다양한 AI 에이전트 플랫폼과 호환되는가?

사용법

# 로컬 SKILL.md 파일 감사
audit-skills /path/to/SKILL.md

# GitHub 저장소의 SKILL.md 감사
audit-skills https://github.com/user/repo/blob/main/SKILL.md

점수 해석

점수 범위	해석
90-100	우수 - 모범 사례를 완벽히 따름
70-89	양호 - 대부분 모범 사례를 따르나 개선 여지 있음
50-69	보통 - 주요 개선 필요
0-49	미흡 - 대대적인 재작성 권장

CI/CD 통합

GitHub Actions 워크플로우에 추가하여 스킬 품질을 자동으로 검사할 수 있습니다:

name: Skill Quality Check
on:
  pull_request:
    paths:
      - 'SKILL.md'

jobs:
  check:
    runs-on: ubuntu-latest
    steps:
      - uses: webkong/skill-quality-check@v1
        with:
          file: SKILL.md

라이선스

MIT