skillcheck: SKILL.md 파일의 크로스 에이전트 호환성 문제를 감지하는 린터

skillcheck의 기능

skillcheck는 agentskills.io 사양에 맞춰 SKILL.md 파일을 검증하는 린터입니다. Claude Code용으로 작성된 스킬이 name 필드 불일치 및 기타 크로스 에이전트 호환성 문제로 VS Code에서 로드되지 않는 문제를 겪은 후 개발되었습니다.

주요 기능

• 발견 가능성을 위한 설명 품질 점수화 (0-100) (에이전트가 이 필드를 사용하여 스킬 활성화 여부를 결정함)
• Claude Code에서만 작동하고 VS Code, Codex, Cursor에서는 작동하지 않는 필드에 대한 경고
• SKILL.md 본문의 파일 참조가 실제 디스크에 존재하는 파일을 가리키는지 확인
• 사양의 점진적 공개 토큰 예산 검증
• CI 통합을 위한 JSON 출력 및 종료 코드 제공
• GitHub Action 포함

설치 및 사용법

pip를 통해 설치: pip install skillcheck

파일이나 디렉토리를 지정하여 실행: skillcheck path/to/skill.md 또는 skillcheck path/to/skills/directory

기술적 세부사항

• Python 3.10+로 구축
• 단일 종속성: PyYAML
• MIT 라이선스
• Claude와 VS Code의 도움으로 구축됨

기존 도구와의 비교

개발자는 skillcheck를 구축하기 전에 skills-ref, cclint, skills-cli, Anthropic의 quick_validate.py를 포함한 모든 기존 검증기의 소스 코드를 읽었습니다. 설명 점수화, 크로스 에이전트 경고, 파일 참조 검사는 기존 도구 중 어느 것에도 존재하지 않습니다. 일부 프론트매터 검증은 기존 검증기와 중복됩니다.