deskstack-doctor — скилл для Claude Code: что делает и как установить
Скилл для Claude Code и Codex тестирует окружение плагина deskstack. Запускается по команде /deskstack-doctor или при ошибках инструментов.
MIT ★ 86 обновлён 2026-11-16
/plugin marketplace add joaquimmj/deskstack
/plugin install deskstack@deskstackЧто делает deskstack-doctor
Скилл проверяет работоспособность компонентов deskstack и собирает диагностический отчёт в виде таблицы. Он опрашивает инструмент data_status коннектора данных, проверяет версию сервера, свежесть снапшота и число европейских эмитентов. Если снапшот старше трёх дней, выдаётся предупреждение о возможном сбое ночного обновления.
Второй этап запускает локальный скрипт scripts/doctor.py. Он проверяет версию Python (нужна версия 3.8 или новее), релиз плагина, загрузку встроенных скриптов ролей и библиотеки openpyxl. Скрипт не требует доступа к сети и ничего не устанавливает сам. В чат-интерфейсе для его работы должно быть включено выполнение кода (Code Execution).
По итогам проверок скилл только формирует сводку статусов со способами устранения неполадок, но сам конфигурацию окружения не меняет. Если коннектор отсутствует, в отчёте даётся прямая команда на подключение MCP-сервера по адресу https://deskstack.deskstack-server.workers.dev/mcp.
Какие задачи решает
- проверить подключение MCP-коннектора deskstack
- протестировать наличие Python 3.8 и библиотеки openpyxl
- выявить устаревший снапшот данных по эмитентам
- получить пошаговые команды для починки окружения deskstack
Примеры запросов агенту
- /deskstack-doctor
- Проверь, почему падает инструмент deskstack
- Запусти диагностику плагина deskstack
Как установить deskstack-doctor
1Через маркетплейс плагинов
/plugin marketplace add joaquimmj/deskstack/plugin install deskstack@deskstackКоманда ставит плагин deskstack целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add joaquimmj/deskstack --skill deskstack-doctor -a claude-code3Вручную: положить файлы
~/.claude/skills/deskstack-doctor/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/deskstack-doctor/
1Через Skills CLI (Vercel)
npx skills add joaquimmj/deskstack --skill deskstack-doctor -a codex2Вручную: положить файлы
.agents/skills/deskstack-doctor/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add joaquimmj/deskstack --skill deskstack-doctor -a cursor2Вручную: положить файлы
.cursor/skills/deskstack-doctor/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install joaquimmj/deskstack plugins/deskstack/skills/deskstack-doctor2Вручную: положить файлы
.github/skills/deskstack-doctor/SKILL.md1Через Skills CLI (Vercel)
npx skills add joaquimmj/deskstack --skill deskstack-doctor -a gemini-cli2Командой платформы
gemini skills install https://github.com/joaquimmj/deskstack --path plugins/deskstack/skills/deskstack-doctorВручную: положить файлы
.devin/skills/deskstack-doctor/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о deskstack-doctor
Как установить deskstack-doctor в Claude Code?
Выполните по очереди команды: /plugin marketplace add joaquimmj/deskstack, а затем /plugin install deskstack@deskstack.
Что делает deskstack-doctor?
Он тестирует окружение плагина deskstack: проверяет MCP-коннектор данных, версию Python, вспомогательные скрипты ролей и выводит отчёт с инструкциями по исправлению ошибок.
Что нужно для работы deskstack-doctor?
Нужен Python 3.8 или новее с разрешённым выполнением кода, а также настроенный HTTP MCP-коннектор deskstack.
Исходный текст
SKILL.md · MIT
---
name: deskstack-doctor
description: Checks that deskstack works here (data connector, plugin version, Python, each role's bundled openpyxl) and says how to fix what doesn't. Use for "/deskstack-doctor" or when a tool fails.
---
# deskstack doctor
Run three checks, then show one table: check, status, detail, fix. You report; you change nothing.
## 1. The data connector
Call the `data_status` tool.
- **It answers:** pass. Report the server `version`, the snapshot's `built_at` and how old it is, and the number of
European issuers.
- A snapshot older than 3 days is a warning: the nightly update may have failed. The data still works.
- **The tool doesn't exist here:** fail. The connector isn't added. Fix: Customize → Connectors → Add custom connector,
paste `https://deskstack.deskstack-server.workers.dev/mcp`, no sign-in. In Claude Code:
`claude mcp add --transport http deskstack https://deskstack.deskstack-server.workers.dev/mcp`.
- **It returns the daily-capacity or rate-limit message:** warning. Quote the message: it says when service comes
back and links the self-hosting guide.
- **Any other error:** fail. Quote it.
## 2. Python, the plugin version and each role's scripts
The script lives in this skill's folder: `${CLAUDE_SKILL_DIR}/scripts/doctor.py` in Claude Code, or
`scripts/doctor.py` next to this SKILL.md in chat and Cowork.
```bash
python3 scripts/doctor.py
```
It checks Python 3.8 or later, the plugin version, and that each role's bundled scripts and openpyxl load. It needs no
network and installs nothing.
- **`python3` isn't found:** fail. In chat and Cowork, code execution must be on (Settings → Capabilities). On your
own machine, install Python 3.8 or later.
- **In chat, the roles show `skip`:** each skill is uploaded on its own there, so this folder can't see the others.
That is expected. Run `/deskstack-doctor` from Claude Code or Cowork for the full check.
## 3. Report
One table, failures first, then: "Everything deskstack needs works here." or the fixes in order. End with the
plugin version.
© Joaquim · MIT · joaquimmj/deskstack