Skills

skill-review

Installation
Summary

Systematic 9-phase audit for claude-skills covering standards, docs verification, code accuracy, and version drift.

  • Validates YAML structure, keywords, third-person style, and directory organization against skill standards
  • Verifies API patterns, imports, and code examples against official documentation, GitHub repos, and npm packages
  • Cross-checks consistency between SKILL.md and README.md, detects stale dependencies (>90 days), and identifies breaking changes
  • Categorizes issues by severity (Critical/High/Medium/Low) with evidence links, auto-fixes unambiguous problems, and bumps versions appropriately
  • Prevents 10 common issues including fake API adapters, outdated method signatures, schema inconsistencies, and broken links
SKILL.md

Skill Review Skill

Process

Invoke: /review-skill <skill-name> or use this skill when detecting outdated patterns

Production evidence: better-auth audit (2025-11-08) - found 6 critical issues including non-existent API imports, removed 665 lines incorrect code, implemented v2.0.0

9-Phase Audit

  1. Pre-Review: Install skill, check version/date, test discovery
  2. Standards: Validate YAML, keywords, third-person style, directory structure
  3. Official Docs: WebFetch/Context7 verify API patterns, GitHub updates, npm versions, production repos
  4. Code Examples: Verify imports exist, API signatures match, schema consistency, templates work
  5. Cross-File Consistency: Compare SKILL.md vs README.md, bundled resources match files
  6. Dependencies: Run ./scripts/check-versions.sh, check breaking changes, verify "Last Verified"
  7. Categorize: Severity (🔴 Critical / 🟡 High / 🟠 Medium / 🟢 Low) with evidence (GitHub/docs/npm)
Related skills

More from jezweb/claude-skills

Installs
358
Repository
jezweb/claude-skills
GitHub Stars
776
First Seen
Jan 20, 2026
Security Audits
Gen Agent Trust HubWarn
SocketPass
SnykWarn