New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Workspace Doctor

by JetXu-LLM in JetXu-LLM/DocMason

Diagnose DocMason workspace readiness and report actionable remediation without mutating the repository.

Apache-2.0Auto-check passedKnowledge Management

Install Workspace Doctor

skills CLI
$ npx skills add JetXu-LLM/DocMason --skill workspace-doctor -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install JetXu-LLM/DocMason workspace-doctor --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/JetXu-LLM/DocMason.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/canonical/workspace-doctor .claude/skills/workspace-doctor && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
workspace-doctor
GitHub stars
147
Token cost
~1k tokens
SKILL.md length
541 words
Files
2
Skills in repo
15
Repo updated
First seen
Licence
Apache-2.0

At a glance

Diagnose DocMason workspace readiness and report actionable remediation without mutating the repository.

  • Works in 8 steps: Run docmason doctor --json. → Explain blockers first, then degraded… → If the environment is not ready and… → …
  • Knowledge Management work in your project
  • SKILL.md covers Required Capabilities, Procedure, Escalation Rules and Completion Signal, plus 1 more section
  • Calls brew; reaches libreoffice.org

What it does

Workspace Doctor is an agent skill from JetXu-LLM/DocMason. Diagnose DocMason workspace readiness and report actionable remediation without mutating the repository.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `workflow.json`).

It sits in Knowledge Management. It works with Homebrew. The repository describes itself as: DocMason is a repo-native agent that turns your complex office files into a local LLM knowledge base and your second brain. The repo is the app. Codex is the runtime. The licence is Apache-2.0.

When your agent uses it

  • Knowledge Management work in your project

Example prompts

  • “/workspace-doctor”

Requirements

  • Python 3

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Run docmason doctor --json.
  2. Explain blockers first, then degraded conditions, then optional follow-up.
  3. If the environment is not ready and .venv is absent, direct the next action to ./scripts/bootstrap-workspace.sh --yes.
  4. Otherwise, if the environment is not ready, direct the next action to docmason prepare --yes.
  5. If doctor reports a control-plane blocker or pending confirmation, surface that blocker before lower-severity degraded conditions.
  6. If office-renderer is blocked
  7. If the normal launcher or prepare path still cannot complete honestly after the governed automatic path has already had enough access…
  8. Return the diagnosis to the main agent without mutating workspace state.

What it can do on your machine

Read from SKILL.md and the folder at commit 37ea2f1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • brew

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • libreoffice.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Workspace Doctor loads about 1k tokens when it runs. Until then it costs about 30 tokens; SKILL.md has 541 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~30
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from JetXu-LLM/DocMason at commit 37ea2f1, republished under its Apache-2.0 licence (© JetXu-LLM). 541 words, ~1,015 tokens.

Download SKILL.mdSave it as .claude/skills/workspace-doctor/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
workspace-doctor
description
Diagnose DocMason workspace readiness and report actionable remediation without mutating the repository.

Workspace Doctor

Use this skill when the task is to inspect the current workspace and explain what is missing or degraded.

Required Capabilities

  • local file access
  • shell or command execution
  • ability to summarize structured diagnostics

If the agent cannot inspect local files or run commands, stop and explain that the workspace cannot be diagnosed reliably.

Procedure

  1. Run docmason doctor --json.
  2. Explain blockers first, then degraded conditions, then optional follow-up.
  3. If the environment is not ready and .venv is absent, direct the next action to ./scripts/bootstrap-workspace.sh --yes.
    • treat the launcher as the governed cold-start preflight and bounded liveness gate for bootstrap Python selection, not as an unbounded trust of whatever python3 happens to be first on PATH
    • on native Codex, the ordinary path should not branch into manual cache probing or manual recovery before that governed launcher settles
  4. Otherwise, if the environment is not ready, direct the next action to docmason prepare --yes.
    • treat mixed and degraded toolchain states as repair-needed, not ordinary ask-time ready
  5. If doctor reports a control-plane blocker or pending confirmation, surface that blocker before lower-severity degraded conditions.
    • for pending native Codex host-access upgrade, direct the next action to switching the thread to Full access
    • for pending high-intrusion prepare, direct the next action to docmason prepare --yes
    • for pending material sync, direct the next action to docmason sync --yes
  6. If office-renderer is blocked:
    • on macOS with Homebrew already present, recommend brew install --cask libreoffice-still or docmason prepare --yes
    • on macOS without Homebrew, recommend docmason prepare --yes or the official installer from https://www.libreoffice.org/download/download/
    • on Linux, recommend the distro package manager or official packages, then re-run doctor
  7. If the normal launcher or prepare path still cannot complete honestly after the governed automatic path has already had enough access, point the deeper fallback to docs/setup/manual-workspace-recovery.md.
  8. Return the diagnosis to the main agent without mutating workspace state.
Show full SKILL.md (228 more words)Show less

Escalation Rules

  • doctor is read-only. Do not silently switch into setup or repair work from inside this workflow.
  • If multiple blockers exist, preserve their ordering and do not hide the highest-severity one behind a degraded follow-up item.
  • Do not downgrade a live control-plane confirmation blocker into a generic degraded suggestion.

Completion Signal

  • The workflow is complete when the main agent has a clear blocker and degraded-condition summary plus the next obvious action.

Notes

  • doctor is read-only.
  • Treat unsupported platforms, unsupported Python versions, and missing editable-install availability as blockers.
  • Treat only a self-contained prepared toolchain as ready for ordinary workspace asks.
  • Treat missing uv, stale adapters, and an empty source corpus as degraded conditions rather than hard blockers.
  • On native Codex/macOS, treat missing LibreOffice as a blocker only when the workspace currently depends on Office rendering. Missing Homebrew alone is informational.
  • On native Codex/macOS, treat Default permissions versus Full access as an explicit first-class boundary; a per-command Yes popup is not equivalent to switching the thread to Full access.
  • Outside that native machine-baseline policy, treat missing LibreOffice as a blocker only when the current corpus contains PPTX, DOCX, or XLSX files.
  • For Claude Code or another compatibility host, keep any higher-access fallback wording brief and host-generic instead of copying the Codex-specific wording.
  • A stale or missing generated adapter matters only when the current flow depends on that adapter surface.

© JetXu-LLM, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/canonical/workspace-doctor of JetXu-LLM/DocMason.

  • SKILL.md
  • workflow.json

Open the folder on GitHubat commit 37ea2f1

Compare with similar skills

Workspace Doctor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Workspace Doctor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Workspace Doctor this skillJetXu-LLM/DocMason147—~1kAutomated safety check: PassApache-2.0
Logseq Review Workflow Evallogseq/logseq45k—~1kAutomated safety check: PassAGPL-3.0
Baoyu URL To Markdownsdyckjq-lab/llm-wiki-skill2.5k2 repos~3.2kAutomated safety check: PassNone
Obsidian CLIAtmosphere/atmosphere3.8k13 repos~795Automated safety check: PassApache-2.0
Esm Cjs Risk Scanlogseq/logseq45k—~3.3kAutomated safety check: PassAGPL-3.0
Knowledge Searchdataelement/bisheng12k—~1.1kAutomated safety check: PassApache-2.0

Similar skills

  • Logseq Review Workflow Eval

    logseq/logseq

    Compare two revisions of the Logseq logseq-review-workflow skill by running the same review prompt against isolated before and after skill snapshots, collecting both outputs, and producing a…

    45k GitHub stars~1k tokensUpdated today
    Knowledge ManagementAuto-check passed

  • Baoyu URL To Markdown

    sdyckjq-lab/llm-wiki-skill

    Fetch any URL and convert to markdown using Chrome CDP. An agent skill from sdyckjq-lab/llm-wiki-skill.

    2.5k GitHub starsUsed in 2 repos~3.2k tokens
    Knowledge ManagementAuto-check passed

  • Obsidian CLI

    Atmosphere/atmosphere

    Interact with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, properties, and more.

    3.8k GitHub starsUsed in 13 repos~795 tokens
    Knowledge ManagementAuto-check passed

  • Esm Cjs Risk Scan

    logseq/logseq

    Scan Logseq ClojureScript Node/Electron targets for npm module loading risks, especially ESM-only packages that may fail when loaded through js/require or shadow-cljs require-based shims.

    45k GitHub stars~3.3k tokensUpdated today
    Knowledge ManagementAuto-check passed

  • Knowledge Search

    dataelement/bisheng

    Search the user's knowledge bases and knowledge spaces (企业知识库检索).

    12k GitHub stars~1.1k tokensUpdated yesterday
    Knowledge ManagementAuto-check passed

  • Capture Conversation

    outline/outline

    Save the current conversation, a decision, or a set of notes as a document in an Outline collection; use when the user wants to keep what was discussed in their knowledge base.

    41k GitHub stars~474 tokensUpdated today
    Knowledge ManagementAuto-check passed

More from JetXu-LLM/DocMason

All 15 skills in this repo

  • Ask

    JetXu-LLM/DocMason

    Accept an ordinary user question inside a DocMason workspace, route it to the right inner workflow, and preserve conversation-native logs automatically.

    147 GitHub stars~7.1k tokensUpdated yesterday
    Auto-check passed

  • Adapter Sync

    JetXu-LLM/DocMason

    Generate or refresh the local Claude adapter surface for DocMason from canonical committed sources.

    147 GitHub stars~684 tokensUpdated yesterday
    Auto-check passed

  • Grounded Answer

    JetXu-LLM/DocMason

    Answer a user question through DocMason's canonical grounded workflow using retrieval, provenance tracing, render escalation, and a final answer-state check.

    147 GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed

  • Grounded Composition

    JetXu-LLM/DocMason

    Produce evidence-backed research, planning, drafting, or composition output from the published DocMason knowledge base while preserving provenance and answer-file discipline.

    147 GitHub stars~2.7k tokensUpdated yesterday
    Auto-check passed

  • Knowledge Base Sync

    JetXu-LLM/DocMason

    Stage, incrementally refresh, validate, and publish the DocMason knowledge base from the local source corpus.

    147 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed

  • Knowledge Construction

    JetXu-LLM/DocMason

    Write bilingual Phase 3 knowledge objects for staged DocMason sources from rendered evidence and extracted structure.

    147 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Workspace Doctor

What does Workspace Doctor do?

Diagnose DocMason workspace readiness and report actionable remediation without mutating the repository. Workspace Doctor is an agent skill from JetXu-LLM/DocMason. Diagnose DocMason workspace readiness and report actionable remediation without mutating the repository.

When should I use Workspace Doctor?

Workspace Doctor fits situations like: knowledge Management work in your project.

How do I install Workspace Doctor in Claude Code?

Run `npx skills add JetXu-LLM/DocMason --skill workspace-doctor -a claude-code`. Or copy the skill folder (skills/canonical/workspace-doctor in JetXu-LLM/DocMason) into .claude/skills/workspace-doctor in your project. Claude Code loads it when a task matches its description.

How do I install Workspace Doctor in Codex?

Run `npx skills add JetXu-LLM/DocMason --skill workspace-doctor -a codex`. Or copy the skill folder (skills/canonical/workspace-doctor in JetXu-LLM/DocMason) into .agents/skills/workspace-doctor in your project. Codex loads it when a task matches its description.

Can I use Workspace Doctor in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add JetXu-LLM/DocMason --skill workspace-doctor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/workspace-doctor, .gemini/skills/workspace-doctor, .github/skills/workspace-doctor and .opencode/skills/workspace-doctor in your project.

What does Workspace Doctor need to run?

Going by SKILL.md and its folder, Workspace Doctor needs the command-line tools its instructions call (brew). Our summary lists: Python 3.

Does Workspace Doctor access the network?

SKILL.md names 1 domain. In commands or code: libreoffice.org; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Workspace Doctor safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Workspace Doctor use?

Workspace Doctor is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Workspace Doctor use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Workspace Doctor?

Skills that share tags, products or a category with Workspace Doctor: Logseq Review Workflow Eval (logseq/logseq, 45k stars), Baoyu URL To Markdown (sdyckjq-lab/llm-wiki-skill, 2.5k stars), Obsidian CLI (Atmosphere/atmosphere, 3.8k stars) and Esm Cjs Risk Scan (logseq/logseq, 45k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Workspace Doctor?

JetXu-LLM (a GitHub user) maintains it in JetXu-LLM/DocMason, which has 147 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 9, 2026.

Source: JetXu-LLM/DocMason on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.