Community코딩 & 개발github.com

pleme-io/skill-lint

Claude Code 스킬 맵 유효성 검사 — 동기화, 프론트매터, 참조, 도메인

skill-lint란 무엇인가요?

이 스킬은 `pleme-io/skill-lint`로, Claude Code 환경에서 사용되는 스킬 맵(Skill Map)의 무결성을 자동으로 검증합니다. 주요 검증 항목으로는 스킬 간 동기화 상태, 프론트매터(Frontmatter)의 올바른 형식, 참조(Reference)의 정확성, 그리고 도메인 정의의 일관성 등이 포함됩니다. 개발자는 이 스킬을 통해 잘못된 설정이나 누락된 정보를 사전에 발견하고 수정할 수 있어, AI 에이전트가 신뢰할 수 있는 스킬 구성을 유지하는 데 도움을 줍니다. Claude Code 플랫폼에서 사용되며, 명령어 기반으로 동작하여 CI/CD 파이프라인에도 통합할 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add pleme-io/skill-lint

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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

Claude Code 스킬 맵 유효성 검사 — 동기화, 프론트매터, 참조, 도메인

개요

이 스킬은 Claude Code 스킬 맵(skill.md 파일 또는 관련 메타데이터)의 유효성을 검사합니다.

주요 기능

  • 동기화 검사: 스킬 맵에 정의된 내용과 실제 파일 시스템 간의 불일치를 확인합니다.
  • 프론트매터 검사: YAML 프론트매터의 필수 필드와 형식이 올바른지 검증합니다.
  • 참조 검사: 다른 스킬이나 리소스를 참조하는 항목의 정확성을 확인합니다.
  • 도메인 검사: 정의된 도메인이 유효한지, 중복되거나 누락된 항목이 없는지 검사합니다.

사용 방법

claude code skill:run pleme-io/skill-lint

또는 특정 경로를 대상으로 실행하려면:

claude code skill:run pleme-io/skill-lint --path ./skills

검사 규칙

  • 모든 스킬 맵 파일은 유효한 YAML 형식이어야 합니다.
  • 프론트매터는 name, description, version 필드를 반드시 포함해야 합니다.
  • 참조는 동일한 저장소 내에 존재하는 파일 또는 공개 스킬만 허용됩니다.
  • 도메인 목록에 중복이 있으면 안 됩니다.

출력 예시

✅ 모든 검사 통과
❌ 오류 발견:
   - skills/my-skill/skill.md: 필수 필드 'version' 누락
   - skills/another-skill/skill.md: 잘못된 참조 'unknown-skill'

라이선스

MIT

관련 스킬