Does it check external documentation for accuracy?

Yes, it uses tools like WebFetch and WebSearch to verify code patterns against official GitHub repositories, npm registries, and technical documentation.

When should I use the skill-review skill?

Use it when a skill seems outdated, after major package updates are detected, before marketplace submissions, or for periodic maintenance every 90 days.

Does it automatically fix errors?

Yes, it auto-fixes unambiguous issues like import errors or formatting while prompting the user for decisions regarding architectural changes or breaking updates.

How does it categorize issues found during an audit?

It classifies findings into four severity levels: Critical (breaks functionality), High (causes confusion), Medium (reduces quality), and Low (minor polish issues).

What does the skill-review tool do?

It performs a deep-dive 14-phase audit on Claude Code skills to ensure they follow best practices, contain accurate API patterns, and remain free of technical errors.

Skill Review & Audit

Name: Skill Review & Audit
Author: secondsky

bysecondsky

•

Developer Tools

Performs a systematic 14-phase audit to ensure Claude Code skills remain accurate, secure, and production-ready.

The skill-review tool is a specialized meta-skill designed to maintain the quality and reliability of documentation and implementation patterns within the sap-skills repository. It executes a comprehensive 14-phase evaluation process—ranging from YAML validation and API verification against official docs to security audits and anti-pattern detection. By combining automated technical checks with AI-powered analysis, it identifies critical issues, prevents version drift, and auto-fixes unambiguous bugs, ensuring that developers always have access to high-quality, verified documentation for their workflows.

Key Features

01Severity-based issue categorization (Critical, High, Medium, Low)

0214-phase systematic audit workflow for comprehensive quality assurance

0311 GitHub stars

04Proactive detection of architectural drift and outdated code examples

05Automated YAML frontmatter validation and standards compliance checks

06Real-time API verification using WebFetch and official documentation

Use Cases

01Performing scheduled maintenance to prevent stale or broken code patterns

02Validating a new skill before submitting it to a public marketplace

03Updating documentation after a major package version release

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add secondsky/sap-skills skill-review

For use in Claude.ai and ChatGPT

Download Skill