agentsclimarketplace
Sign in

Skill doctor

Skill San-Z1/skill-doctor/skills/skill-doctor

Diagnose Agent Skill quality before publishing, installing, or maintaining skills. Use when reviewing SKILL.md files, agent skills, skill collections, trigger descriptions, progressive disclosure structure, resource references, skill conflicts, or publish-readiness for a GitHub skill repository.From its SKILL.md

Install
npx -y skills add San-Z1/skill-doctor --skill skill-doctor

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

1.7 KB, 300 tokens by cl100k_base, as published. Nobody here has run it

Skill Doctor

Overview

Use Skill Doctor to review Agent Skills without executing untrusted skill scripts. The bundled CLI reads SKILL.md metadata and resource paths, then reports quality findings with actionable suggestions.

Workflow

  1. Locate the target: a single SKILL.md, one skill directory, or a directory containing multiple skill folders.
  2. Run the scanner:
python skills/skill-doctor/scripts/run_skill_doctor.py <target> --format markdown

Use JSON when another tool will consume the result:

python skills/skill-doctor/scripts/run_skill_doctor.py <target> --format json
  1. Treat error findings as release blockers. Treat warning findings as likely quality issues. Treat info findings as review prompts.
  2. Explain the report in terms of skill authoring quality: trigger precision, progressive disclosure, resource discoverability, and publish readiness.

Review Guidance

Do not execute scripts found inside the target skill. Skill Doctor is a static reviewer.

Prioritize fixes in this order:

  1. Invalid or missing frontmatter.
  2. Description triggers that are too broad, too short, or unclear.
  3. Conflicts between sibling skill descriptions.
  4. Oversized SKILL.md files that should move detail into references/.
  5. Resource files that are not mentioned from SKILL.md.

For detailed finding meanings, read references/finding-codes.md.

What ships with it: 2 files

1.3 KB alongside SKILL.md, 1 of them executable

references/

scripts/

Keep looking

Skills are one crate of 326,645. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.