# Skill Doctor

Environment diagnostics, check providers, auth, config, hooks, scheduler, and more

- Repository: https://github.com/nyldn/claude-octopus (4351 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add nyldn/claude-octopus --skill skill-doctor -g -a claude-code -y`
Codex: `npx skills add nyldn/claude-octopus --skill skill-doctor -g -a codex -y`
Cursor: `npx skills add nyldn/claude-octopus --skill skill-doctor -g -a cursor -y`
Gemini CLI: `npx skills add nyldn/claude-octopus --skill skill-doctor -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add nyldn/claude-octopus`

## Description

Environment diagnostics, check providers, auth, config, hooks, scheduler, and more

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Environment Doctor

## Overview

Run environment diagnostics across 15 check categories. Doctor 2.0 identifies
misconfigured providers, stale loaded or cached plugin versions, invalid plugin
assembly, unwritable state, non-terminal run records, orphan process evidence,
broken hooks, and other issues that prevent Claude Octopus from working
correctly.

**Core principle:** Detect problems before they surface in workflows.

---

## When to Use

**Use this skill when:**
- Something isn't working and you're not sure why
- After installing or updating the plugin
- Before a demo or important workflow run
- Checking if providers are properly authenticated
- Verifying scheduler, hooks, or skills are correctly configured

**Do NOT use for:**
- First-time setup (use `/octo:setup`, it guides configuration)
- Project workflow status (use `/octo:status`)
- Debugging application code (use `/octo:debug`)

---

## The Process

### Step 1: Resolve Plugin Root and Run Full Diagnostics

Use this resolver before running Octopus scripts. Prefer the active host root,
then the stable root or the installed CLI. Do not create or replace a stable
link while collecting diagnostics. Run this as a single Bash call.

The rest: https://github.com/nyldn/claude-octopus/blob/HEAD/.claude/skills/skill-doctor/SKILL.md