skill-doctor MCP — Сценарии использования, Установка & Живое демо

Зачем использовать

Ключевые функции

Проверяет заголовок SKILL.md и метаданные YAML.
Обнаруживает неработающие ссылки и недостающие ресурсы пакета.
Описание триггера баллов и ясность инструкций
Проверяет схему evals/evals.json.
Оценка 0–100 с практическими выводами
Форматы вывода: текст, JSON, только оценка.
Встроенный шаблон рабочего процесса GitHub Actions.

Живое демо

Как выглядит на практике

skill-doctor-skill.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %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. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "skill-doctor-skill": {
      "command": "npx",
      "args": [
        "-y",
        "skill-doctor@latest",
        "."
      ],
      "_inferred": false
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "skill-doctor-skill": {
      "command": "npx",
      "args": [
        "-y",
        "skill-doctor@latest",
        "."
      ],
      "_inferred": false
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "skill-doctor-skill": {
      "command": "npx",
      "args": [
        "-y",
        "skill-doctor@latest",
        "."
      ],
      "_inferred": false
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "skill-doctor-skill",
      "command": "npx",
      "args": [
        "-y",
        "skill-doctor@latest",
        "."
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "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.

Сценарии использования

Реальные сценарии: skill-doctor

Проверьте свои навыки перед публикацией на торговой площадке

👤 Авторы навыков собираются поделиться SKILL.md ⏱ ~15 min beginner

Когда использовать: Вы завершили освоение навыка и хотите пройти проверку здравомыслия, прежде чем кто-либо другой его установит.

Предварительные требования

Узел 18+ — установка нвм 18

Поток

Беги к доктору

Запустите мастер-доктор в корне навыка.✓ Скопировано

→ Оценка + список результатов по степени тяжести
Исправьте элементы высокой важности

Сначала устраните серьезные проблемы; повторяйте забег до тех пор, пока балл не станет ≥ 85.✓ Скопировано

→ Оценка поднимается; критика исчезает

Итог: Навык, который активируется, когда вы этого ожидаете, и не имеет неработающих ссылок.

Подводные камни

В погоне за идеальной сотней — Проблемы с низкой степенью серьезности (гниды стиля) часто подходят; сосредоточьтесь на триггерах и ресурсах

Сочетать с: oaustegard-claude-skills

Создайте репозиторий навыков с минимальным показателем качества в CI

👤 Команды, поддерживающие несколько навыков в одном репозитории ⏱ ~30 min intermediate

Когда использовать: Вы часто отправляете навыки и хотите предотвратить снос.

Предварительные требования

Действия GitHub (или эквивалент) — Репо с .github/workflows/

Поток

Добавьте рабочий процесс

Добавьте задание GH Actions, которое запускает мастер-доктор и завершается сбоем, если оценка < 80.✓ Скопировано

→ Добавлен файл рабочего процесса; работает на пиаре
Установить строгость для каждого пути

Производственные навыки терпят неудачу < 90; сквозняки допускают < 70.✓ Скопировано

→ Матрица или условные пороги в рабочем процессе

Итог: ПИ, которые ухудшают качество навыков, ловятся до слияния.

Подводные камни

Зафиксировать планку слишком высоко и слишком рано — Начните с разрешительного режима, затем ужесточайте его в течение 2–3 месяцев, когда результаты будут зафиксированы.

Сочетать с: agent-skills-cli-skill

Диагностируйте, почему навык не активируется

👤 Квалифицированные пользователи с проблемами активации ⏱ ~15 min beginner

Когда использовать: Вы установили навык, но Клод его не активирует.

Поток

Запустите доктора в каталоге навыков.

Запустите Skill-Doctor на ~/.claude/skills/<skill>.✓ Скопировано

→ Результаты указывают на проблемы со слабым триггером или основной темой.
Изменить описание

Перепишите описание, чтобы в нем присутствовали конкретные ключевые слова для задач пользователя.✓ Скопировано

→ Снижение четкости триггера

Итог: Более четкая активация; Клод подбирает навык под нужные задачи.

Комбинации

Сочетайте с другими MCP — эффект x10

skill-doctor-skill + oaustegard-claude-skills

Проверка перед публикацией на торговой площадке

Запустите скилл-доктор локально; затем откройте PR для oaustegard/claude-skills.✓ Скопировано

skill-doctor-skill + agent-skills-cli-skill

Соедините скилл-доктор с другими инструментами для разработки скиллов.

Используйте агент-skills-cli для создания каркаса; скилл-доктор для проверки перед фиксацией.✓ Скопировано

skill-doctor-skill + claude-skill

Следуйте руководству по авторству, затем lint

Пишите согласно руководству по навыкам Клауда; проверьте с помощью специалиста-врача.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
skill-doctor <path>	skill directory path	Перед публикацией, в CI или для диагностики проблем активации.	0

Стоимость и лимиты

Во что обходится

Квота API: Нет — локальный статический анализ
Токенов на вызов: Нет (CLI, а не API)
Деньги: Бесплатно
Совет: Запускать только в измененных каталогах; в CI используйте фильтры путей, чтобы избежать сканирования всего репозитория при каждом PR.

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: Нет учетных данных

Исходящий трафик: Нет — только локальный анализ

врач-специалист сообщает о структурных проблемах; он не оценивает безопасность. Высокий балл ≠ безопасный навык — все равно просмотрите, что навык требует от Клода.

Устранение неполадок

Частые ошибки и исправления

Врач говорит, что SKILL.md не найден

Запускайте из корня навыка (каталог, содержащий SKILL.md), а не из корня репозитория.

Проверить: ls SKILL.md in CWD

Сбои схемы 'evals/evals.json'

Убедитесь, что каждое eval имеет обязательные поля; Минимальная заглушка лучше сломанной.

Проверить: jq . evals/evals.json

Оценка не улучшается после правок

Повторный запуск; Если обнаружение сохраняется, прочтите степень серьезности и подробности — иногда исправления приводят к появлению новых проблем низкой серьезности.

Проверить: Diff the JSON reports between runs

Альтернативы

skill-doctor в сравнении

Альтернатива	Когда использовать	Компромисс
agent-skills-cli-skill	Вам нужны общие инструменты CLI для навыков построения леса/управления.	Другой набор функций; не линтер
claude-skill	Вы хотите, чтобы авторское руководство понимало, что такое «хорошо»	Документы, а не линтер

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills