agent-skill-validator은(는) 무엇을 하나요?
AI 스킬 검사기 및 에이전트 스킬 검증기: 폴더, ZIP, .skill 번들, SKILL.md 파일, 스크립트, 참조, 링크, 에셋 및 토큰 예산 검증.
개요
이 도구는 AI 에이전트 스킬의 품질을 보장하기 위해 설계되었습니다. 스킬 디렉토리, ZIP 아카이브, 또는 .skill 번들을 분석하여 필수 구성 요소가 올바르게 포함되고, 참조가 유효하며, 토큰 예산이 적절한지 확인합니다.
주요 기능
- SKILL.md 검증: 필수 섹션, 구문 오류, 메타데이터 일관성 확인
- 스크립트 검증: 포함된 스크립트의 실행 가능성 및 의존성 검사
- 참조 및 링크 확인: 모든 내부 및 외부 링크의 유효성 검사 (선택 사항)
- 에셋 검증: 이미지, 데이터 파일 등 필요한 에셋이 누락되지 않았는지 확인
- 토큰 예산 평가: SKILL.md 및 관련 파일의 예상 토큰 사용량 계산 및 경고
- 번들 검증:
.skill파일의 내부 구조 검증
사용 방법
# 폴더 검증
agent-skill-validator ./my-skill
# ZIP 파일 검증
agent-skill-validator ./my-skill.zip
# .skill 번들 검증
agent-skill-validator ./my-skill.skill
지원 플랫폼
- Claude Code
- Cursor
- Codex
- 기타 SKILL.md 기반 에이전트 플랫폼
환경 변수
| 변수 | 설명 | 기본값 |
|---|---|---|
SKILL_VALIDATOR_DEBUG | 디버그 로그 활성화 | false |
SKILL_VALIDATOR_LINK_CHECK | 외부 링크 검사 활성화 | true |
SKILL_VALIDATOR_TOKEN_LIMIT | 스킬당 최대 토큰 수 | 8000 |
예제
# 자세한 출력과 함께 검증
agent-skill-validator --verbose ./my-skill
# 토큰 예산만 확인
agent-skill-validator --check-tokens ./my-skill
라이선스
MIT