Skip to main content
skill CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add joaquimmj/deskstack
/plugin install deskstack@deskstack
Open on GitHub

What 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@deskstack

This installs the whole deskstack plugin with all its skills

2Skills CLI (Vercel)

npx skills add joaquimmj/deskstack --skill deskstack-doctor -a claude-code

3Manually: put the files in place

~/.claude/skills/deskstack-doctor/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/deskstack-doctor/

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

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set19

The whole set →
company-snapshot The company-snapshot Claude Code skill builds a one-page profile of a public company in the US or EU. It brings together five years of financials, calculated metrics, and filing references. CX Codex +1 ★ 86repo stars wacc wacc is a Claude Code skill that calculates WACC step by step and cites each input. It runs for company cost-of-capital requests. CX Codex +1 ★ 86repo stars eu-company The eu-company Claude Code skill finds a listed European company by name or LEI and retrieves IFRS figures from its ESEF annual reports. It returns annual figures only, with no LTM data. CX Codex +1 ★ 86repo stars comps This Claude Code skill builds a trading comparables table from filings data. A request for company comps starts the workflow, which uses user-supplied share prices or market caps. CX Codex +1 ★ 86repo stars compliance compliance — a skill for Claude Code checks a workbook and memo before they are shared. It reviews number sourcing, dated user inputs, and language about buying or selling. CX Codex +1 ★ 86repo stars guide The guide skill for Claude Code explains deskstack reports and connector setup. It activates when someone asks about a metric, a report, or installing deskstack. CX Codex +1 ★ 86repo stars deal-team The deal-team Claude Code skill runs a company valuation through analysis and review stages. Start it for a quick DCF or comps task. CX Codex +1 ★ 86repo stars conventions The conventions Claude Code skill sets formatting and sourcing rules for financial work. It applies across deskstack roles, from analyst tasks to VP reviews. CX Codex +1 ★ 86repo stars

Project sponsors

Companies that keep this analytics open