AgentStack
Browse Sign in
Browse Why AgentStack Sell Docs
Sign in
SKILL verified MIT Self-run

Skill Doctor

skill-san-z1-skill-doctor-skill-doctor · by San-Z1

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.

↗ Repository
— No reviews yet
0 installs
5 views
0.0% view→install

Install

$ agentstack add skill-san-z1-skill-doctor-skill-doctor

✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • ✓ Prompt-injection patterns
  • ✓ Secret / credential exfiltration
  • ✓ Dangerous shell & filesystem operations
  • ✓ Untrusted network calls
  • ✓ Known-malicious package signatures

What it can access

  • ✓ Network access No
  • ✓ Filesystem access No
  • ✓ Shell / process execution No
  • ✓ Environment & secrets No
  • ✓ Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

View the full security report →

Verified badge

Passed review? Show it. Paste this badge into your README, it links to the public security report.

AgentStack Verified badge Links to your public security report.
[![AgentStack Verified](https://agentstack.voostack.com/badges/verified.svg)](https://agentstack.voostack.com/security/report/skill-san-z1-skill-doctor-skill-doctor)

Reliability & compatibility

✓ Security review passed
0 installs to date
— no reviews yet
● 1mo ago

Declared compatibility

Claude CodeClaude Desktop

Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.

Preview Execution monitoring

We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.

How agent discovery & health will work →
Are you the author of Skill Doctor? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

About

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  --format markdown

Use JSON when another tool will consume the result:

python skills/skill-doctor/scripts/run_skill_doctor.py  --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.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet, be the first.

Write a review

Versions

  • v0.1.0 Imported from the upstream source.

More in Developer Tools