제작: marian2js · marian2js/skill-doctor
배송 전에 Claude 기술을 린트하세요. 서문, 리소스 참조, 트리거 명확성, 평가 위생, 심각도 점수는 0~100점입니다.
Skill-Doctor는 로컬 기술 패키지를 스캔하고 활성화, 안정성 또는 품질을 손상시키는 문제를 표시하는 CLI입니다. YAML 머리말과 메타데이터를 확인하고, 리소스 참조가 손상되지 않았는지 확인하고, 명확성을 위해 트리거 설명을 평가하고, 'evals/evals.json'의 유효성을 검사합니다. 출력은 심각도가 표시된 결과가 포함된 0~100점입니다. 텍스트, JSON 및 점수 전용 모드를 지원하므로 사전 커밋, 사전 경로 또는 CI 게이팅에 적합합니다.
언제 쓸까: 기술을 완료하고 다른 사람이 설치하기 전에 온전한 패스를 원합니다.
결과: 예상할 때 활성화되고 참조가 끊어지지 않는 스킬입니다.
언제 쓸까: 기술을 자주 출시하고 드리프트 방지를 원합니다.
결과: 스킬 품질을 저하시키는 PR은 병합 전에 적발됩니다.
언제 쓸까: 스킬을 설치했지만 클로드가 스킬을 발동시키지 않습니다.
결과: 더 명확한 활성화; Claude는 올바른 작업에 적합한 기술을 선택합니다.
마켓플레이스에 게시하기 전 Lint
다른 스킬 작성 도구와 체인 스킬 닥터
저작 가이드를 따른 다음 Lint를 따르세요.
| 도구 | 입력 | 언제 호출 | 비용 |
|---|---|---|---|
| skill-doctor <path> | skill directory path | 게시 전, CI에서 또는 활성화 문제를 진단하기 위해 | 0 |
의사가 SKILL.md를 찾을 수 없다고 합니다.repo 루트가 아닌 스킬 루트(SKILL.md가 포함된 디렉터리)에서 실행합니다.
ls SKILL.md in CWD'evals/evals.json' 스키마 오류각 평가에 필수 필드가 있는지 확인하세요. 최소한의 스텁이 부서지는 것보다 낫습니다.
jq . evals/evals.json편집 후 점수가 향상되지 않습니다.재실행; 결과가 지속되면 심각도와 세부 정보를 읽어보세요. 때로는 수정으로 인해 심각도가 낮은 새로운 문제가 발생하는 경우도 있습니다.
Diff the JSON reports between runs| 대안 | 언제 쓰나 | 단점/장점 |
|---|---|---|
| agent-skills-cli-skill | 스캐폴딩/관리 기술을 위한 일반 CLI 도구가 필요합니다. | 다양한 기능 세트; 린터가 아니다 |
| claude-skill | 저작 가이드가 '좋은' 것이 무엇인지 이해하기를 원합니다. | 린터가 아닌 문서 |