Validate Skills
skills/ 내 모든 스킬을 agentskills.io 스펙 및 Claude Code 모범 사례에 대해 검증합니다.
검증 체크리스트
각 스킬 디렉터리에 대해 다음을 확인합니다:
스펙 적합성 (agentskills.io)
| 확인 항목 | 규칙 |
|---|---|
name 형식 | 1-64자, 소문자 영숫자 + 하이픈, 앞/뒤/연속 하이픈 없음 |
name과 디렉터리 일치 | 디렉터리 이름이 name 필드와 같아야 함 |
description 길이 | 1-1024자, 비어 있지 않아야 함 |
| 선택 필드 유효성 | license, metadata, compatibility가 존재할 경우 유효해야 함 |
모범 사례 (Claude Code)
| 확인 항목 | 규칙 |
|---|---|
| 설명 형식 | 3인칭, 무엇을 + 언제 사용할지 설명 |
| 본문 길이 | 500줄 이내 |
| 로딩 깊이는 1단계 | SKILL.md가 유일한 점진적 공개 진입점: 모든 참조 파일은 SKILL.md에서 도달 가능해야 함. 참조 파일은 탐색을 위해 서로 교차 링크할 수 있음 (아래 참고). |
| 링크는 마크다운 형식 | 파일 이름이 아닌 [텍스트](https://raw.githubusercontent.com/callstackincubator/agent-skills/main/경로) 사용 |
| 중복 금지 | 설명을 본문에서 반복하지 않음 |
| 간결성 | Claude가 이미 알지 못하는 맥락만 추가 |
1단계 깊이 vs. 교차 링크. 1단계 깊이 규칙은 점진적 공개 로딩 체인을 대상으로 합니다. 즉, 다른 참조를 먼저 로드해야만 발견할 수 있는 참조(
SKILL.md→a.md→b.md, 여기서b.md는SKILL.md에 링크되지 않음)입니다. 이는 로더로부터 콘텐츠를 숨기므로 결함입니다.탐색적 교차 링크를 금지하지 않습니다. AGENTS.md에 따라 참조 파일은 형제 참조를 연결하는 "관련 스킬" 바닥글로 끝나며, 이는 필수입니다. 두 엔드포인트가
SKILL.md에서 직접 도달 가능하기만 하면 교차 링크는 괜찮습니다. 오직 다른 참조를 통해서만 도달 가능한 참조만 문제로 표시하십시오.
실행 방법
-
모든 스킬 디렉터리를 찾습니다:
fd -t d -d 1 . skills/ -
각 스킬에 대해
SKILL.md를 읽고 위 규칙에 따라 검사합니다. -
다음 형식으로 문제를 보고합니다:
## 검증 결과 ### skills/example-skill - [통과] name 형식 유효 - [실패] name "example"이(가) 디렉터리 "example-skill"과(와) 일치하지 않음 - [통과] description 길이 정상 (156자)