How do I install the Skill Review skill?

Run npx skillmds@latest add majiayu000/skill-review-4 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Skill Review safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Skill Review?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Skill Review free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Skill Review?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Skill Review by majiayu000 — Agent Skill

Name: Skill Review
Rating: 4.666666666666667 (3 reviews)
Author: majiayu000

Skill Review

Audit claude-skills repository documentation with systematic 9-phase review: standards compliance, official docs verification via Context7/WebFetch, code examples accuracy, cross-file consistency, and version drift detection. Auto-fixes unambiguous issues with severity classification. Use when: investigating skill issues, major package updates detected (e.g., v1.x → v2.x), skill not verified >90 days, before marketplace submission, or troubleshooting outdated API patterns, contradictory examples, broken links, version drift.

majiayu000 Updated Sep 22, 2026 567 repo stars

File contents

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

Pre-Review: Install skill, check version/date, test discovery
Standards: Validate YAML, keywords, third-person style, directory structure
Official Docs: WebFetch/Context7 verify API patterns, GitHub updates, npm versions, production repos
Code Examples: Verify imports exist, API signatures match, schema consistency, templates work
Cross-File Consistency: Compare SKILL.md vs README.md, bundled resources match files
Dependencies: Run ./scripts/check-versions.sh, check breaking changes, verify "Last Verified"
Categorize: Severity (🔴 Critical / 🟡 High / 🟠 Medium / 🟢 Low) with evidence (GitHub/docs/npm)
Fix: Auto-fix unambiguous, ask user for architectural, update all files, bump version
Verify: Test discovery, templates work, no contradictions, commit with changelog

Automated (via ./scripts/review-skill.sh): YAML syntax, package versions, broken links, TODOs, file org, staleness

Manual (AI): API methods vs docs, GitHub issues, production comparisons, code correctness, schema consistency

Severity Classification

🔴 CRITICAL: Non-existent API/imports, invalid config, missing dependencies

🟡 HIGH: Contradictory examples, inconsistent patterns, outdated major versions

🟠 MEDIUM: Stale minors (>90d), missing docs sections, incomplete errors

🟢 LOW: Typos, formatting, missing optional metadata

Fix Decision

Auto-fix: Unambiguous (correct import from docs), clear evidence, no architectural impact

Ask user: Multiple valid approaches, breaking changes, architectural choices

Version Bumps

Major (v1→v2): API patterns change
Minor (v1.0→v1.1): New features, backward compatible
Patch (v1.0.0→v1.0.1): Bug fixes only

Example: better-auth Audit (2025-11-08)

🔴 CRITICAL #1: Non-existent d1Adapter import from 'better-auth/adapters/d1'

Evidence: Official docs show drizzleAdapter, GitHub has no d1Adapter export, 4 production repos use Drizzle/Kysely
Fix: Replaced with drizzleAdapter from 'better-auth/adapters/drizzle'

Result: 3 files deleted (obsolete), 3 created (correct patterns), +1,266 lines, v1.0→v2.0, 3.5 hours

Issues Prevented (10)

Fake API adapters - Non-existent imports
Stale API methods - Changed signatures
Schema inconsistency - Different table names
Outdated scripts - Deprecated approaches
Version drift - Packages >90 days old
Contradictory examples - Multiple conflicting patterns
Broken links - 404 URLs
YAML errors - Invalid frontmatter
Missing keywords - Poor discoverability
Incomplete bundled resources - Listed files don't exist

Bundled Resources

Planning: planning/SKILL_REVIEW_PROCESS.md (complete 9-phase guide)

Scripts: scripts/review-skill.sh (automated validation)

Commands: .claude/commands/review-skill.md (slash command)

Last Verified: 2025-11-28 | Version: 1.0.0

---name: skill-review-4description: Audit claude-skills repository documentation with systematic 9-phase review: standards compliance, official docs verification via Context7/WebFetch, code examples accuracy, cross-file consistency, and version drift detection. Auto-fixes unambiguous issues with severity classification. Use when: investigating skill issues, major package updates detected (e.g., v1.x → v2.x), skill not verified >90 days, before marketplace submission, or troubleshooting outdated API patterns, contradictory examples, broken links, version drift.---# Skill Review Skill## ProcessInvoke: `/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 Audit1. **Pre-Review**: Install skill, check version/date, test discovery2. **Standards**: Validate YAML, keywords, third-person style, directory structure3. **Official Docs**: WebFetch/Context7 verify API patterns, GitHub updates, npm versions, production repos4. **Code Examples**: Verify imports exist, API signatures match, schema consistency, templates work5. **Cross-File Consistency**: Compare SKILL.md vs README.md, bundled resources match files6. **Dependencies**: Run `./scripts/check-versions.sh`, check breaking changes, verify "Last Verified"7. **Categorize**: Severity (🔴 Critical / 🟡 High / 🟠 Medium / 🟢 Low) with evidence (GitHub/docs/npm)8. **Fix**: Auto-fix unambiguous, ask user for architectural, update all files, bump version9. **Verify**: Test discovery, templates work, no contradictions, commit with changelog**Automated** (via `./scripts/review-skill.sh`): YAML syntax, package versions, broken links, TODOs, file org, staleness**Manual** (AI): API methods vs docs, GitHub issues, production comparisons, code correctness, schema consistency---## Severity Classification🔴 **CRITICAL**: Non-existent API/imports, invalid config, missing dependencies🟡 **HIGH**: Contradictory examples, inconsistent patterns, outdated major versions🟠 **MEDIUM**: Stale minors (>90d), missing docs sections, incomplete errors🟢 **LOW**: Typos, formatting, missing optional metadata## Fix Decision**Auto-fix**: Unambiguous (correct import from docs), clear evidence, no architectural impact**Ask user**: Multiple valid approaches, breaking changes, architectural choices## Version Bumps- **Major** (v1→v2): API patterns change- **Minor** (v1.0→v1.1): New features, backward compatible- **Patch** (v1.0.0→v1.0.1): Bug fixes only---## Example: better-auth Audit (2025-11-08)**🔴 CRITICAL #1**: Non-existent `d1Adapter` import from `'better-auth/adapters/d1'`- **Evidence**: Official docs show drizzleAdapter, GitHub has no d1Adapter export, 4 production repos use Drizzle/Kysely- **Fix**: Replaced with `drizzleAdapter` from `'better-auth/adapters/drizzle'`**Result**: 3 files deleted (obsolete), 3 created (correct patterns), +1,266 lines, v1.0→v2.0, 3.5 hours---## Issues Prevented (10)1. **Fake API adapters** - Non-existent imports2. **Stale API methods** - Changed signatures3. **Schema inconsistency** - Different table names4. **Outdated scripts** - Deprecated approaches5. **Version drift** - Packages >90 days old6. **Contradictory examples** - Multiple conflicting patterns7. **Broken links** - 404 URLs8. **YAML errors** - Invalid frontmatter9. **Missing keywords** - Poor discoverability10. **Incomplete bundled resources** - Listed files don't exist---## Bundled Resources**Planning**: `planning/SKILL_REVIEW_PROCESS.md` (complete 9-phase guide)**Scripts**: `scripts/review-skill.sh` (automated validation)**Commands**: `.claude/commands/review-skill.md` (slash command)---**Last Verified**: 2025-11-28 | **Version**: 1.0.0

Frequently asked questions