제작: marian2js · marian2js/skill-doctor
배송 전에 Claude 기술을 린트하세요. 서문, 리소스 참조, 트리거 명확성, 평가 위생, 심각도 점수는 0~100점입니다.
Skill-Doctor는 로컬 기술 패키지를 스캔하고 활성화, 안정성 또는 품질을 손상시키는 문제를 표시하는 CLI입니다. YAML 머리말과 메타데이터를 확인하고, 리소스 참조가 손상되지 않았는지 확인하고, 명확성을 위해 트리거 설명을 평가하고, 'evals/evals.json'의 유효성을 검사합니다. 출력은 심각도가 표시된 결과가 포함된 0~100점입니다. 텍스트, JSON 및 점수 전용 모드를 지원하므로 사전 커밋, 사전 경로 또는 CI 게이팅에 적합합니다.
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"skill-doctor-skill": {
"command": "npx",
"args": [
"-y",
"skill-doctor@latest",
"."
],
"_inferred": false
}
}
}Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.
{
"mcpServers": {
"skill-doctor-skill": {
"command": "npx",
"args": [
"-y",
"skill-doctor@latest",
"."
],
"_inferred": false
}
}
}Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.
{
"mcpServers": {
"skill-doctor-skill": {
"command": "npx",
"args": [
"-y",
"skill-doctor@latest",
"."
],
"_inferred": false
}
}
}Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.
{
"mcpServers": {
"skill-doctor-skill": {
"command": "npx",
"args": [
"-y",
"skill-doctor@latest",
"."
],
"_inferred": false
}
}
}Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.
{
"mcpServers": [
{
"name": "skill-doctor-skill",
"command": "npx",
"args": [
"-y",
"skill-doctor@latest",
"."
]
}
]
}Continue는 맵이 아닌 서버 오브젝트 배열 사용.
{
"context_servers": {
"skill-doctor-skill": {
"command": {
"path": "npx",
"args": [
"-y",
"skill-doctor@latest",
"."
]
}
}
}
}context_servers에 추가. 저장 시 Zed가 핫 리로드.
claude mcp add skill-doctor-skill -- npx -y skill-doctor@latest .한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.
언제 쓸까: 기술을 완료하고 다른 사람이 설치하기 전에 온전한 패스를 원합니다.
결과: 예상할 때 활성화되고 참조가 끊어지지 않는 스킬입니다.
언제 쓸까: 기술을 자주 출시하고 드리프트 방지를 원합니다.
결과: 스킬 품질을 저하시키는 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 | 저작 가이드가 '좋은' 것이 무엇인지 이해하기를 원합니다. | 린터가 아닌 문서 |