skill-reviewer

Audit Claude Skills against Anthropic's official guide principles.

Updated Feb 9, 2026
One-click install
npx skills add https://github.com/ousiass/claude-config --skill skill-reviewer-ousiass
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-reviewer
Source: https://github.com/ousiass/claude-config/tree/main/skills/skill-reviewer
Command: npx skills add https://github.com/ousiass/claude-config --skill skill-reviewer-ousiass

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you identify and fix common issues in your Claude Skills, ensuring they are concise, efficient, and adhere to best practices.

Core Features & Use Cases

  • Comprehensive Auditing: Evaluates skills against 5 key principles (Conciseness, Progressive Disclosure, Degrees of Freedom, Composability, Portability).
  • Actionable Recommendations: Provides specific suggestions for improvement, including code examples and refactoring strategies.
  • Use Case: Before sharing a new skill with your team, run it through skill-reviewer to catch potential problems and ensure it meets quality standards, saving you review time later.

Quick Start

Use the skill-reviewer to audit my 'my-database-skill'.

Frequently Asked Questions about skill-reviewer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit my Claude Skills against Anthropic's official guide principles?

You can audit Claude Skills by evaluating their SKILL.md, scripts, and references directories against five key principles: conciseness, progressive disclosure, degrees of freedom, composability, and portability. This process provides scored evaluations and specific improvement recommendations.

What is the best way to refactor an existing SKILL.md for better progressive disclosure?

To refactor a SKILL.md for better progressive disclosure, analyze the file structure to identify hidden complexities and suggest reorganizations. This approach yields specific refactoring strategies and optionally generates an improved skill version that aligns with best practices.

How do I check if my custom skill meets code quality and documentation standards?

Checking custom skill documentation standards involves running a comprehensive auditing process that evaluates the skill against conciseness and portability principles. This generates a scored evaluation that catches potential problems before team distribution.

Can I generate an improved version of my skill automatically after identifying issues?

Yes, you can generate an improved skill version automatically. After analyzing the SKILL.md, scripts, and references to identify structural issues, the process provides optional generation of a refined version with actionable code examples.

Does the skill review process evaluate both scripts and references directories?

Yes, the skill review process evaluates scripts and references directories. It requires analysis of these components alongside the SKILL.md file to identify issues across composability and degrees of freedom, ensuring a complete quality audit.

What are the limitations of auditing skills using these five specific principles?

The limitation of this auditing approach is its strict focus on conciseness, progressive disclosure, degrees of freedom, composability, and portability. It evaluates structural alignment with Anthropic's guide principles rather than testing runtime execution or functional logic.