Skip to content
BeClaude

claude-skill-doctor

New
GitHub TrendingGeneralby forgeron-AI

Audit and repair Claude skills that misbehave — 7-criteria grid, 5-case test protocol, corrected SKILL.md delivered.

Summary

This skill audits and repairs Claude Code skills that misbehave by evaluating them against a 7-criteria grid and running a 5-case test protocol.

  • md file, saving debugging time and ensuring reliable skill behavior.

Install & Usage

1
Create the skills directory
mkdir -p .claude/skills
2
Download the skill file
mkdir -p .claude/skills && curl -o .claude/skills/claude-skill-doctor.md https://raw.githubusercontent.com/forgeron-AI/claude-skill-doctor/main/SKILL.md
3
Invoke in Claude Code
/claude-skill-doctor

Use Cases

Audit a custom Claude skill that fails to execute correctly in the terminal.
Repair a skill with broken or ambiguous instructions that cause unexpected outputs.
Validate a newly written skill against best practices before sharing it with a team.
Debug a skill that works intermittently by running the 5-case test protocol.
Standardize multiple skills across a project to meet a consistent quality grid.
Quickly fix a skill that throws errors due to malformed YAML or missing fields.

Usage Examples

1

/claude-skill-doctor audit ./skills/my-skill.md

2

Run the 5-case test protocol on the skill 'data-analyzer' and output a corrected SKILL.md.

3

Audit all skills in the current directory and list those failing the 7-criteria grid.

View source on GitHub
testing

Security Audits

LicenseUnknownSourceWarnRepositoryPass

Frequently Asked Questions

What is claude-skill-doctor?

This skill audits and repairs Claude Code skills that misbehave by evaluating them against a 7-criteria grid and running a 5-case test protocol. It helps developers quickly identify issues in their skill definitions and delivers a corrected SKILL.md file, saving debugging time and ensuring reliable skill behavior.

How to install claude-skill-doctor?

To install claude-skill-doctor: create the skills directory (mkdir -p .claude/skills), then run: mkdir -p .claude/skills && curl -o .claude/skills/claude-skill-doctor.md https://raw.githubusercontent.com/forgeron-AI/claude-skill-doctor/main/SKILL.md. Finally, /claude-skill-doctor in Claude Code.

What is claude-skill-doctor best for?

claude-skill-doctor is a skill categorized under General. It is designed for: testing. Created by forgeron-AI.

What can I use claude-skill-doctor for?

claude-skill-doctor is useful for: Audit a custom Claude skill that fails to execute correctly in the terminal.; Repair a skill with broken or ambiguous instructions that cause unexpected outputs.; Validate a newly written skill against best practices before sharing it with a team.; Debug a skill that works intermittently by running the 5-case test protocol.; Standardize multiple skills across a project to meet a consistent quality grid.; Quickly fix a skill that throws errors due to malformed YAML or missing fields..