What does the /ork:doctor command do?

It runs a comprehensive suite of diagnostic tests on your OrchestKit installation to ensure all components like skills, agents, and hooks are properly configured and operational.

What happens if a health check fails?

The doctor provides specific exit codes and actionable troubleshooting steps, such as suggesting specific 'npm run' commands to fix synchronization or validation errors.

When should I run the doctor skill?

It is best practice to run it after updates, when hooks fail to fire, after a new build, or before deploying your AI toolkit to a production or team environment.

Can I use this skill in a CI/CD pipeline?

Yes, the skill supports a --json flag specifically designed for machine-readable output and automated integration into your CI workflows.

Does it check my Claude Code version?

Yes, it validates that you are running a compatible version of Claude Code (minimum 2.1.16) to ensure all plugin features function correctly.

OrchestKit Health Diagnostics

Name: OrchestKit Health Diagnostics
Author: yonatangross

byyonatangross

•

Security & Testing

Diagnoses and validates the health of OrchestKit installations to ensure skills, agents, and hooks are correctly configured.

OrchestKit Health Diagnostics (doctor) is a comprehensive validation tool designed to ensure your Claude Code environment is optimized and error-free. It performs multi-category checks including skill frontmatter integrity, agent tool references, hook registration patterns, and 3-tier memory system health. By auto-detecting installed plugins and monitoring context token budgets, it helps developers prevent deployment failures and troubleshoot complex coordination issues within their AI development workflows.

Key Features

01Automated skill and agent frontmatter validation

02Multi-tier memory system integrity checks (Graph, Mem0, Fabric)

03Hook registration and async pattern health monitoring

0469 GitHub stars

05Claude Code version and context token budget analysis

06CI-ready JSON output for automated health reporting

Use Cases

01Verifying configuration after installing or updating OrchestKit

02Debugging issues when hooks or skills are not behaving as expected

03Integrating health checks into CI/CD pipelines before team deployment

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add yonatangross/orchestkit doctor

For use in Claude.ai and ChatGPT

Download Skill