skill-doctor SKILL.md skillA

skill-doctor from nyldn/claude-octopus is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add nyldn/claude-octopus/skill-doctor@git:20260912.87fcc2b

Pins git:20260912.87fcc2b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
nyldn/claude-octopus
Path
.claude/skills/skill-doctor/SKILL.md
Versions recorded
6
Latest version
git:20260912.87fcc2b, committed Sep 12, 2026
First version recorded
Aug 12, 2026
Size
18,244 bytes
Repository stars
4,265
License
MIT

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

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 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
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add nyldn/claude-octopus/skill-doctor@sha256:92e2493d3301b3cb

The line at the top of this page pins the label git:20260912.87fcc2b, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_lw35yendqgvj5egw.svg)](https://markdownregistry.com/a/art_lw35yendqgvj5egw)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 6 versions of this file, between Aug 12, 2026 and Sep 12, 2026, about one every 6 days.

versioncommittedcommitsizeaudit
git:20260912.87fcc2b latest2026-09-12 87fcc2b 18,244 BA view · diff
git:20260827.23554ef2026-08-27 23554ef 16,639 BA view · diff
git:20260826.dd4cb942026-08-26 dd4cb94 16,409 BA view · diff
git:20260813.c53db382026-08-13 c53db38 15,273 BA view · diff
git:20260813.14437ae2026-08-13 14437ae 14,610 BA view · diff
git:20260812.99ee2c62026-08-12 99ee2c6 14,587 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (18244 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

nyldn/claude-octopus · 4,265 stars · license MIT · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_lw35yendqgvj5egw
GET https://markdownregistry.com/api/v1/resolve?ref=nyldn/claude-octopus/skill-doctor
GET https://markdownregistry.com/api/v1/blob/92e2493d3301b3cb3f3709db04fd426326db3f8b89c584ba68c478b53341e422

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from nyldn/claude-octopus

skill-extract SKILL.md skill
nyldn/claude-octopus · .claude/skills/extract-skill/SKILL.md · Reverse-engineer design systems, tokens, and components from live products or screenshots
git:20260813.14437ae · audit A · 4,265 stars
flow-define SKILL.md skill
nyldn/claude-octopus · .claude/skills/flow-define/SKILL.md · Multi-AI requirements scoping using available external providers (Double Diamond Define phase). Priority triggers: octo…
git:20260929.dbf6863 · audit A · 4,265 stars
flow-deliver SKILL.md skill
nyldn/claude-octopus · .claude/skills/flow-deliver/SKILL.md · Multi-AI validation, scoring, and review using available external providers (Double Diamond Deliver phase)
git:20260929.dbf6863 · audit A · 4,265 stars
flow-develop SKILL.md skill
nyldn/claude-octopus · .claude/skills/flow-develop/SKILL.md · Multi-AI implementation using available external providers (Double Diamond Develop phase). DO NOT use for simple code…
git:20261002.5c257fc · audit A · 4,265 stars
flow-discover SKILL.md skill
nyldn/claude-octopus · .claude/skills/flow-discover/SKILL.md · Multi-AI research using available external providers (Double Diamond Discover phase)
git:20260929.dbf6863 · audit A · 4,265 stars
flow-parallel SKILL.md skill
nyldn/claude-octopus · .claude/skills/flow-parallel/SKILL.md · Decompose and execute large changes, migrations, or multi-issue fixes in parallel with quality gates
git:20261007.9f7aada · audit A · 4,265 stars
flow-spec SKILL.md skill
nyldn/claude-octopus · .claude/skills/flow-spec/SKILL.md · NLSpec authoring — use when you need a structured specification from multi-AI research and consensus
git:20261002.5c257fc · audit A · 4,265 stars
skill-agent-topology SKILL.md skill
nyldn/claude-octopus · .claude/skills/skill-agent-topology/SKILL.md · Audit whether a multi-agent setup earns its coordination cost — use before adding an agent, or when a workflow feels…
git:20260813.14437ae · audit A · 4,265 stars
octopus-architecture SKILL.md skill
nyldn/claude-octopus · .claude/skills/skill-architecture/SKILL.md · Review system architecture, simplify boundaries, or compare interface designs from repository evidence
git:20260907.4febbb1 · audit A · 4,265 stars
skill-audit SKILL.md skill
nyldn/claude-octopus · .claude/skills/skill-audit/SKILL.md · Audit codebases for quality, consistency, and broken patterns — use for pre-release or tech debt review
git:20260907.4febbb1 · audit A · 4,265 stars
skill-authoring SKILL.md skill
nyldn/claude-octopus · .claude/skills/skill-authoring/SKILL.md · Principles for writing skills that behave the same way every run — use when adding, editing, or reviewing a skill in…
git:20260907.4febbb1 · audit A · 4,265 stars
skill-code-review SKILL.md skill
nyldn/claude-octopus · .claude/skills/skill-code-review/SKILL.md · Expert multi-AI code review with inline PR comments — use for thorough quality and security analysis
git:20260814.ef54249 · audit A · 4,265 stars

Every file in nyldn/claude-octopus

Other files named skill-doctor

skill-doctor SKILL.md skill
nyldn/claude-octopus · skills/skill-doctor/SKILL.md · Environment diagnostics — check providers, auth, config, hooks, scheduler, and more
git:20260912.87fcc2b · audit A · 4,265 stars
skill-doctor SKILL.md skill
outlinedriven/odin-claude-plugin · plugins/odin-agent/skills/skill-doctor/SKILL.md · Use when a user wants agent setup graded from conversation history. Not for skill fixing: use agent-surface-forge. Not…
git:20260905.de5d264 · audit A · 38 stars
skill-doctor SKILL.md skill
ibrahimsobh/aiskills · skill-doctor/SKILL.md · Diagnose an existing AI Skill (SKILL.md) — plain explanation of what/why/how/when, an optional workflow diagram, a…
git:20261008.d40a8a2 · audit A · 7 stars
skill-doctor SKILL.md skill
pengqianhan/ai-human-research-os · research-skills-hub/collected-skills/skill-doctor/SKILL.md · Grades agent skills by scoring agent conversations against efficiency and code-quality rubrics, then drafts concrete…
git:20260914.cbf07f7 · audit A · 3 stars

Browse by kind, by grade A, or by owner.