Find the skill

Search in order: ~/.claude/skills/{skill_name}/SKILL.md → ~/.claude/skills/{skill_name}/*.md → .rulesync/skills/{skill_name}/SKILL.md. Read completely, including referenced files.

Self-assessment first

Form your own verdict before research — research without a prior assessment produces parroting, not judgment. Default bias: a skill usually wants to get shorter. Cutting bloat is worth as much as adding technique.

Assess the skill as a prompt for an executing agent, not a doc for a human — this is the higher-value lens; most skills have adequate coverage but weak prompt engineering. Note for each finding which competitive source would confirm or refute it. Also flag capability gaps and self-contradiction — what the skill should do but doesn't, where it contradicts its own stated philosophy — not just prompt-craft.

Rubric (these feed the report's section-2 table):

improve-skill

Find the skill

Self-assessment first