Skill Review
This is quality control for your Claude skills. It loads a skill's SKILL.md, checks it against documented best practices across five dimensions (structure, description, workflow, token efficiency, anti-patterns), and returns concrete fixes, not vague advice. The iron law is brutal: never say "could be improved" without stating exactly what to change. Use it when you've written a skill and want to know if your workflow actually guides the model or if your description is too abstract to route properly. The review format leads with what works (quoted, specific) before prioritized suggestions with before/after examples. Think of it as a linter that understands prompt engineering principles, not just syntax.
- skills.sh installs
- 2.4K
- GitHub stars
- 4K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add sanyuan0704/sanyuan-skills --skill skill-review --agent claude-codeInstalls into .claude/skills of the current project.
Files
Skill Review
IRON LAW: Be specific and actionable. Never say "could be improved" without stating exactly what to change and why it matters for model output quality.
Workflow
Skill Review Progress:
- [ ] Step 1: Load Target ⚠️ REQUIRED
- [ ] 1.1 Identify skill path
- [ ] 1.2 Read SKILL.md and inventory all files
- [ ] Step 2: Analyze ⚠️ REQUIRED
- [ ] 2.1 Structure compliance
- [ ] 2.2 Description quality
- [ ] 2.3 Workflow design
- [ ] 2.4 Token efficiency
- [ ] 2.5 Anti-pattern detection
- [ ] Step 3: Report ⚠️ REQUIRED
- [ ] 3.1 Strengths (what's done well)
- [ ] 3.2 Suggestions (prioritized improvements)
Step 1: Load Target ⚠️ REQUIRED
Identify the skill to review. Accept:
- Explicit path:
/skill-review path/to/skill - Current directory context: if user is already in a skill folder
- Skill name: search within the workspace for matching skill directory
Read the full SKILL.md and list all files in the skill directory. Count SKILL.md line count — this is a key metric.
Step 2: Analyze ⚠️ REQUIRED
Load references/review-criteria.md for detailed criteria. Evaluate the skill across five dimensions:
2.1 Structure Compliance
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/sanyuan0704/sanyuan-skills
- Categories
- Git & Pull Requests, Code Review & Quality, Automation & Workflows, Design & UI/UX
- First seen
- Jun 3, 2026
More from sanyuan0704/sanyuan-skills
All 6Recommended
More Git & Pull Requests
peer-reviewk-dense-ai/scientific-agent-skillsPrepare evidence-bounded, constructive peer-review drafts and structured manuscript assessments. Use for authorized review of scientific manuscripts, protocols,2.3Kskills.sh installs
typescript-reviewmetabase/metabaseReview TypeScript and JavaScript code changes for compliance with Metabase coding standards, style violations, and code quality issues. Use when reviewing pull 2.3Kskills.sh installs
design-review-processowl-listener/designer-skillsEstablish design review gates with criteria, checklists, and approval workflows.2.3Kskills.sh installs
sqlalchemy-alembic-expert-best-practices-code-reviewwispbit-ai/skillsSQLAlchemy ORM and Alembic migration best practices for building safe, performant database schemas. This skill should be used when writing, reviewing, or refact2.1Kskills.sh installsclojure-reviewmetabase/metabaseReview Clojure and ClojureScript code changes for compliance with Metabase coding standards, style violations, and code quality issues. Use when reviewing pull 2Kskills.sh installs