1. Habit
  2. Skills
  3. Skill Review skill
sanyuan0704 · 2K installs

Skill Review skill
Runs by itself, SKILL.md changed.

Every skill change gets reviewed.

Install the Skill Review skill and make it a habit: follow https://gethabit.dev/skills/sanyuan0704/skill-review.md

  1. 1Copy
  2. 2Paste into Claude Code, Codex or Cursor
  3. 3It runs by itself

2K installs4K starsMIT licenceSource on GitHub ↗

Skill Review

by sanyuan0704 · 2K installs

The skill

The skill review skill helps skill authors audit Claude Code skills for structure, description quality, workflow design, token efficiency and anti-patterns, with specific fixes.

Only when you ask.

The habit

Every skill change gets reviewed.

↻ Runs by itselfSKILL.md changed

How the habit works.
You don't have to.

Three questionsWhen does it start? How does it check its work? What does it remember?

01

It starts by itself

SKILL.md changed. Runs in GitHub Actions or Claude Code routine.

  • ↻ SKILL.md changed
  • pull_request touches **/SKILL.md

02

It checks its work

structure checks pass. If a check fails, it tells you.

  • ✓SKILL.md is under 500 lines
  • ✓frontmatter holds only allowed keys
  • ✓no TODO, FIXME, xxx or TBD left
  • ✓report lists at least 2 strengths and each suggestion has What, Where and Fix

03

It remembers

skill reviews log. The next run reads it first: earlier suggestions for the same skill.

loops/skill-review-loop/run-log.md

One run, step by step.
Then it stops.

Stop ruleStops after one skill per run.

  1. 01

    Load target

    Read the full SKILL.md, list all files and count its lines.

  2. 02

    Analyze

    Check the five dimensions with references/review-criteria.md.

  3. 03

    Find anti-patterns

    Look for vague directives, placeholders and a missing pre-delivery checklist.

  4. 04

    Report

    Write strengths with quotes, then suggestions sorted by impact.

What it may do.
Nothing more.

Safe by defaultIt writes only in its own folder and asks you before anything goes out.

Is it for you?
Use it when it fits.

Quick checkRead both lists. If the left one sounds like you, the Skill Review skill helps.

Use it when

  • ✓ You want to review a skill
  • ✓ You lint a SKILL.md
  • ✓ You improve a skill's description

Skip it when

  • – You review application code
  • – You need to write a skill from scratch

Questions

Skill Review skill, answered.

Will it push extra features?

No. The skill warns against flagging features a simple skill leaves out on purpose.

What does a suggestion include?

What the issue is, where it is, and a concrete fix.

How do I install the Skill Review skill?

Copy the prompt at the top into your agent. It installs the skill from sanyuan0704/sanyuan-skills and sets up the habit. Or run npx skills add sanyuan0704/sanyuan-skills --skill skill-review.

Is the Skill Review skill free?

Yes. It is published under MIT. Habit is free too.

Skill Review. Now as a habit.

Install the Skill Review skill and make it a habit: follow https://gethabit.dev/skills/sanyuan0704/skill-review.md

  • Free
  • No account
  • Undo in one line

All sanyuan0704 skills →More docs skills →

Works in

  • Claude Code
  • Codex
  • Cursor
  • ChatGPT
  • Claude app

Made by sanyuan0704, published under MIT. Habit links to the original and never changes it. Is this your skill?

Copying didn't work here. Select the line and copy it by hand.