Can it fix identified issues automatically?

The Skill Reviewer focuses on auditing and reporting; it provides the roadmap for improvements which can then be implemented manually or with the help of a skill-optimizer.

What are P1 recommendations in the review report?

P1 recommendations are critical issues that must be fixed, such as invalid YAML formatting, broken file paths, or missing essential purpose statements.

What is PDA compliance in Claude Code?

Progressive Disclosure Architecture (PDA) is a method of organizing skill content into smaller, on-demand reference files to minimize token usage and improve model performance.

Does it check for naming conventions?

Yes, it validates that skill names are lowercase, use hyphens, are under 64 characters, and do not use reserved words like 'anthropic' or 'claude'.

How does this skill help save tokens?

It identifies monolithic files and calculates potential savings by recommending a split into a small core SKILL.md and on-demand reference documents.

Skill Reviewer for Claude Code

Name: Skill Reviewer for Claude Code
Author: jovermier

byjovermier

0•

Developer Tools

Audits and optimizes Claude Code skills to ensure they follow best practices, maintain PDA compliance, and maximize token efficiency.

Skill Reviewer provides a comprehensive auditing framework for developers building Claude Code skills. It evaluates skill structures against Progressive Disclosure Architecture (PDA) standards, validates YAML frontmatter, checks for proper file organization, and identifies opportunities to optimize token usage. By generating detailed reports with prioritized recommendations and token savings estimates, it helps authors create high-quality, performant, and maintainable skills that provide a superior user experience and lower operational costs.

Key Features

01Token efficiency assessment and savings estimation

02Automated YAML frontmatter and structural validation

03Detailed reporting with prioritized P1/P2/P3 recommendations

040 GitHub stars

05Cross-platform file organization and naming convention checks

06Progressive Disclosure Architecture (PDA) compliance auditing

Use Cases

01Refactoring large monolithic skills into optimized, multi-file structures

02Identifying token-heavy prompt patterns that can be optimized via PDA

03Evaluating skill quality and structure before publishing or sharing

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jovermier/claude-code-plugins-ip-labs skill-reviewer

For use in Claude.ai and ChatGPT

Download Skill