skill-doctor

Diagnose environment health across Octopus components and report remediation steps.

1|Updated Jun 12, 2026
One-click install
npx skills add https://github.com/mhdxbilal/Ai --skill skill-doctor-mhdxbilal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-doctor
Source: https://github.com/mhdxbilal/Ai/tree/main/.claude/skills/skill-doctor
Command: npx skills add https://github.com/mhdxbilal/Ai --skill skill-doctor-mhdxbilal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Environment diagnostics that surface misconfigurations, stale state, and broken integrations across the Claude Octopus plugin, ensuring workflows run smoothly.

Core Features & Use Cases

  • Run a comprehensive health check across providers, authentication, configuration, state, hooks, and scheduler.
  • Identify misconfigurations and stale state before executing critical workflows or demos.
  • Get actionable remediation guidance to fix issues quickly and reliably.

Quick Start

Run /octo:doctor to execute all diagnostic categories and view a full health report.

Frequently Asked Questions about skill-doctor

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

FAQPage Schema
How do I diagnose provider and authentication misconfigurations in Octopus?

Run a comprehensive environment health check to diagnose provider and authentication misconfigurations in Octopus. The Doctor validates all components, surfaces stale state, and provides concrete remediation steps to fix issues quickly.

What is the best way to verify environment readiness before a plugin update or demo?

Verifying environment readiness before a plugin update or demo requires running a full diagnostic sweep across providers, authentication, config, state, hooks, and scheduler. This health check identifies broken integrations and misconfigurations to ensure workflows run smoothly.

How do I fix broken hooks and runtime settings in my Octopus environment?

To fix broken hooks and runtime settings in your Octopus environment, execute a diagnostic health check. The Doctor validates these specific components and generates actionable remediation guidance to resolve detected failures.

Does the Octopus doctor check validate configuration and state across all components?

Yes, the Octopus doctor check validates configuration and state across all components. It inspects providers, authentication, hooks, and runtime settings, then reports concrete remediation steps for any misconfigurations or stale state it discovers.

Why do my Octopus workflows fail after installation, and how do I troubleshoot them?

Octopus workflows often fail after installation due to environment misconfigurations or stale state. Troubleshoot them by running a diagnostic health check that surfaces broken integrations across providers, auth, config, and hooks with specific remediation guidance.

When should I run environment diagnostics on my Octopus plugin setup?

Run environment diagnostics on your Octopus plugin setup before executing critical workflows, installing updates, or giving demos. This proactive health check prevents failures by identifying misconfigurations and stale state across all components beforehand.