deskstack-doctor — Claude Code skill: what it does, how to install
Skill for Claude Code and Codex that diagnoses the deskstack environment. Runs on the /deskstack-doctor command or whenever a tool fails.
MIT ★ 86 updated 2026-11-16
/plugin marketplace add joaquimmj/deskstack
/plugin install deskstack@deskstackWhat deskstack-doctor does
This diagnostic skill verifies that deskstack components function properly and compiles a single status table. It calls the data_status tool to check the server version, snapshot age, and European issuer counts. A snapshot older than three days triggers a warning that the nightly update pipeline might have stalled.
The second stage runs scripts/doctor.py directly from the skill folder. It tests for Python 3.8 or newer, verifies the plugin release version, and ensures that role scripts alongside bundled openpyxl import cleanly. The script runs entirely offline without installing packages, though chat interfaces require active code execution privileges.
All findings appear in an issue table listing failures first alongside clear remediation steps. The skill reports issues without applying automated changes to the system. Missing connectors receive an explicit manual fix via https://deskstack.deskstack-server.workers.dev/mcp.
What it helps with
- verify deskstack MCP data connector availability
- test local Python 3.8 and openpyxl dependencies
- detect outdated data snapshots past the three-day threshold
- generate exact command fixes for broken deskstack tools
Example prompts for the agent
- /deskstack-doctor
- Run diagnostics on deskstack tools
- Check why the deskstack connector failed
How to install deskstack-doctor
1Plugin marketplace
/plugin marketplace add joaquimmj/deskstack/plugin install deskstack@deskstackThis installs the whole deskstack plugin with all its skills
2Skills CLI (Vercel)
npx skills add joaquimmj/deskstack --skill deskstack-doctor -a claude-code3Manually: put the files in place
~/.claude/skills/deskstack-doctor/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/deskstack-doctor/
1Skills CLI (Vercel)
npx skills add joaquimmj/deskstack --skill deskstack-doctor -a codex2Manually: put the files in place
.agents/skills/deskstack-doctor/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add joaquimmj/deskstack --skill deskstack-doctor -a cursor2Manually: put the files in place
.cursor/skills/deskstack-doctor/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install joaquimmj/deskstack plugins/deskstack/skills/deskstack-doctor2Manually: put the files in place
.github/skills/deskstack-doctor/SKILL.md1Skills CLI (Vercel)
npx skills add joaquimmj/deskstack --skill deskstack-doctor -a gemini-cli2Platform CLI
gemini skills install https://github.com/joaquimmj/deskstack --path plugins/deskstack/skills/deskstack-doctorManually: put the files in place
.devin/skills/deskstack-doctor/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about deskstack-doctor
How to install deskstack-doctor in Claude Code?
Run /plugin marketplace add joaquimmj/deskstack, then run /plugin install deskstack@deskstack.
What does deskstack-doctor do?
It inspects the deskstack installation, confirms MCP connector connectivity, tests Python and bundled openpyxl dependencies, and provides actionable fix instructions.
What is required to run deskstack-doctor?
It requires Python 3.8 or higher, active code execution permissions, and the remote deskstack MCP connector.
Source text
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