Skill Doctor

Audit local Agent Skills catalogs and installed skill roots, then apply only narrow metadata repairs when requested.

Arguments

• --root PATH: Scan this catalog or installed skill root. Repeatable. Default: current working directory.
• --format text|json: Select report format. Default: text.
• --fix-safe: Create missing agents/openai.yaml files or update mismatched policy.allow_implicit_invocation.
• --include-shelved: Include shelved/*/SKILL.md in metadata checks. Shelved skills are never required in README.md.

Workflow

1. Resolve the skill directory, then run the helper from that directory:

   uv run scripts/skill-doctor.py "$ARGUMENTS"