# Skill Doctor

> Audit a skill against Pocock's write-a-skill spec and return a prioritized, diagnose-only fix report.

- **Type:** Skill
- **Install:** `agentstack add skill-kytixo-skill-doctor-skill-doctor`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [KyTiXo](https://agentstack.voostack.com/s/kytixo)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [KyTiXo](https://github.com/KyTiXo)
- **Source:** https://github.com/KyTiXo/skill-doctor

## Install

```sh
agentstack add skill-kytixo-skill-doctor-skill-doctor
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Skill Doctor

> Audits a skill against Matt Pocock's `write-a-skill` (the enforced Review Checklist) and
> `writing-great-skills` (the deeper principles). Diagnose-first — the two gates below never move.

## 🔒 Two gates (never cross)

1. **Diagnose** — once the target skill is picked, only read and produce a report. Change nothing.
2. **Refactor** — after the report, wait for an explicit "go fix it" before editing. A report is not consent.

Refactoring touches only the target skill's own directory. Never other files, never user data.

## Flow

1. Read the target `SKILL.md` in full, plus any linked `references/`.
2. Score it against every row in `references/checklist.md` — five sections: Invocation, Structure, Steps, Pruning, Hygiene.
3. Write the gate-1 report via `references/report-template.md` (content only).
   Exception: user said `with tags` or `include meta-params` upfront → also fill
   `references/meta-params-template.md` in the report (propose only, no writes).
4. Stop at gate 1 — change nothing.

## The five checks

Invocation · Structure · Steps · Pruning · Hygiene. Full criteria live in `references/checklist.md` —
score every row from that file, never from memory.

## Failure-mode lookup

Name the smell when you find it: **premature completion**, **duplication**, **sediment**, **sprawl**,
**no-op**, **blind-guess**. Tell + first fix for each: `references/checklist.md` § Failure-mode lookup.

## Refactor (only after gate 2)

Back up first: `cp SKILL.md SKILL.md.bak-`. Then apply the report's prioritized fix list in order.
Re-check the line count and grep the leading words to confirm nothing got lost in the move.

## Meta-params pass (opt-in — default after gate 2)

Run only on explicit request. Default timing: after content refactor. Upfront exception:
`with tags` / `include meta-params` in the audit invocation → proposals in gate-1 report.

Propose via `references/meta-params-template.md` + `references/optimize-tags.md`.
Nothing writes until the user consents — bulk (`apply the tags`) or cherry-pick (name the rows).
Run each validation test before writing; skip or revert on request.
Never mix tag writes into the content refactor unless the same message explicitly approves both.

## Source & license

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

- **Author:** [KyTiXo](https://github.com/KyTiXo)
- **Source:** [KyTiXo/skill-doctor](https://github.com/KyTiXo/skill-doctor)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-kytixo-skill-doctor-skill-doctor
- Seller: https://agentstack.voostack.com/s/kytixo
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.