skills.rest
GongYuanCaiJi
GongYuanCaiJiCOMMUNITY
Explore all skills by this author →
GitHub

skill-doctor

Diagnoses provider, auth, config, hook, and scheduler issues across 14 environment check categories.

Updated Aug 15, 2026
Search Tags:#authentication#troubleshooting#orchestration#environment#health check#diagnostics#provider cli
One-click install
npx skills add https://github.com/GongYuanCaiJi/dsh-claude-octopus --skill skill-doctor-gongyuancaiji
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-doctor
Source: https://github.com/GongYuanCaiJi/dsh-claude-octopus/tree/main/.claude/skills/skill-doctor
Command: npx skills add https://github.com/GongYuanCaiJi/dsh-claude-octopus --skill skill-doctor-gongyuancaiji

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a multi-provider AI orchestration setup stops working, it is hard to tell whether the cause is a missing CLI, expired authentication, stale state, broken hooks, or a misconfigured scheduler. This Skill runs structured environment diagnostics to pinpoint the problem before it derails a workflow. ## Core Features & Use Cases - 14 check categories: Covers providers, companions, auth, config, updates, state, smoke tests, hooks, scheduler, skills, conflicts, agents, recurrence, and cache, with verbose and JSON output modes. - Dependency checking and installation: Detects missing CLIs (Codex, Antigravity, jq, RTK) and offers guided installation, including interactive remediation prompts for fixable issues. - Use Case: After updating the plugin, your multi-model research command fails silently. Run the doctor to discover that the Codex CLI authentication expired, then re-login and confirm all checks pass before your demo. ## Quick Start Ask the assistant to run Octopus doctor diagnostics to check whether your providers, authentication, and hooks are all working correctly.

Frequently Asked Questions about skill-doctor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if my AI provider CLIs are installed and authenticated?▼

Run the doctor diagnostics with the providers or auth category to verify CLI installation and authentication status for Codex, Antigravity, Perplexity, and Ollama. The report identifies missing CLIs and expired credentials with specific fix commands.

How to run environment diagnostics for Claude Octopus?▼

Ask the assistant to run Octopus doctor diagnostics, which resolves the plugin root and executes orchestrate.sh doctor --verbose across all 14 check categories. You can also target a single category such as doctor auth or doctor hooks.

Can I get machine-readable diagnostic output for automation?▼

Yes, run the doctor with the --json flag to get machine-readable output suitable for scripting. Combine it with a category filter, such as doctor auth --json, to limit the scope of the report.

Why does the doctor report a circuit breaker as OPEN?▼

An OPEN circuit breaker means a provider had three or more consecutive transient failures and was temporarily disabled. Wait for the cooldown period or check the provider's service status before retrying.

When should I not use the doctor diagnostics?▼

Do not use it for first-time setup, which belongs to the setup workflow, or for project workflow status, which belongs to the status command. It also does not debug application code; use a dedicated debugging workflow for that.

Related Skills

Explore More Software Engineering Skills→
Folly-PartnersFolly-Partners

first-run-plugins

Guide first-run onboarding by recommending and installing Claude plugins after claudesync setup.

Official
Basic
PacificStudioPacificStudio
264

setup-gh-cli

Install gh CLI and verify GitHub authentication status.

Official
Intermediate
kunalrawat425kunalrawat425

health

Aggregate type checks, linting, tests, and dead-code detection into a weighted 0-10 health score.

Community
Intermediate
CarlosQ96CarlosQ96

smoke-check

Run smoke tests and generate PASS/FAIL reports for QA hand-off.

Community
Intermediate