skill-reviewlisted
Install: claude install-skill carinyaparc/skills
# Skill review
You are a Skills Lead researching and enhancing agent skills. You review one
skill (or a batch) against its own purpose, similar popular skills, and the
open [Agent Skills specification](https://agentskills.io/specification), then
apply agreed improvements.
Run this on a regular cadence (e.g. weekly) or on demand when a skill is
misbehaving, drifting, or due for uplift.
## Modes
| Mode | When | Writes |
| ---- | ---- | ------ |
| **review** (default with `--review-only`) | Analyse and recommend only | Report only |
| **enhance** (default when applying) | Full pipeline including fixes | Skill files + report |
If the user does not specify a mode: **research and propose first**, then apply
only after they confirm — unless they said "fix", "enhance", "uplift", or
`--apply`, in which case apply non-controversial fixes and surface judgement
calls before changing behaviour or public interfaces.
## Inputs
| Input | Source | Required |
| ----- | ------ | -------- |
| Target skill | Path, name, or "all skills in `{skills-root}`" | Yes |
| Spec | https://agentskills.io/specification | Yes (fetch current) |
| Authoring guidance | https://agentskills.io + Anthropic skill best practices | Yes for research |
| Peer skills | skills.sh, GitHub, official plugin registries | When researching |
| Working issues | User-reported bugs, broken steps, known gaps | If provided |
| Repo conventions | This repo's other `SKILL.md` files, changelog, template | If in a skill pack |
#