skills.rest
shawn-sandy
shawn-sandyCOMMUNITY
Explore all skills by this author →
Website𝕏@shawnsandyGitHub

reviewing-skills

Audit SKILL.md files against Anthropic's Claude Code authoring best practices.

2|Updated Jan 19, 2026
Search Tags:#developer tools#skill quality#skill review#SKILL.md audit#claude code best practices#code authoring
One-click install
npx skills add https://github.com/shawn-sandy/agentics --skill reviewing-skills-shawn-sandy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reviewing-skills
Source: https://github.com/shawn-sandy/agentics/tree/main/plugins/skill-reviewer/skills/reviewing-skills
Command: npx skills add https://github.com/shawn-sandy/agentics --skill reviewing-skills-shawn-sandy

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the review of SKILL.md files, ensuring they adhere to Anthropic's best practices for Claude Code skill authoring, thereby improving skill quality and discoverability.

Core Features & Use Cases

  • Structured Audit: Scores skills across 5 dimensions (Frontmatter, Body Quality, Structure, Anti-patterns, Discoverability).
  • Best Practice Enforcement: Identifies violations of naming conventions, length limits, and structural requirements.
  • Regression Analysis: Compares current SKILL.md against its last commit to detect breaking changes.
  • Optimized Version Generation: Offers to create a corrected version of the SKILL.md file.
  • Use Case: A developer has just finished writing a new Claude Code skill and wants to ensure it meets all quality standards before submission or deployment. They use this skill to get a comprehensive audit report and a corrected file.

Quick Start

Use the reviewing-skills skill to audit the SKILL.md file located at plugins/my-skill/skills/my-skill/SKILL.md.

Frequently Asked Questions about reviewing-skills

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

FAQPage Schema
How do I audit a SKILL.md file for Claude Code best practices?▼

To audit a SKILL.md file for Claude Code best practices, run a review tool that scores frontmatter validity, body quality, structure, anti-patterns, and discoverability. It evaluates the file against official standards and provides a scored report to improve skill quality.

What is a SKILL.md anti-pattern in Claude Code skill authoring?▼

A SKILL.md anti-pattern is a structural or content violation of Claude Code skill authoring best practices, such as improper naming conventions, exceeding length limits, or missing structural requirements. Auditing identifies these issues to ensure optimal skill quality and discoverability.

How do I check a SKILL.md file for regression risks before deployment?▼

To check a SKILL.md file for regression risks, compare the current file against its last commit to detect breaking changes. This regression analysis ensures updates do not introduce structural failures or violate previously established best practices.

Can I automatically generate an optimized SKILL.md file from an existing one?▼

Yes, you can automatically generate an optimized SKILL.md file from an existing one. After auditing the file against best practices, the tool offers to create a corrected version that fixes identified anti-patterns, naming violations, and structural issues.

What dimensions are evaluated in a SKILL.md quality review?▼

A SKILL.md quality review evaluates five dimensions: Frontmatter, Body Quality, Structure, Anti-patterns, and Discoverability. This structured audit scores each area to ensure the skill adheres to Anthropic's official Claude Code authoring standards.

Related Skills

Explore More Software Engineering Skills→
bs-koobs-koo

commit

Generate Korean Git commit messages from branch types and staged changes.

Community
Advanced
pr-pmpr-pm
121

Example Package Two Skill

Publish multiple packages from a single prpm.json manifest.

Community
Basic
NotysotyNotysoty
9

Prompt Version Control Workflow

Automate prompt version control with evaluation gates and rollback workflows.

Community
Intermediate
zhizhunbaozhizhunbao

dev-markdown_check

Validate and correct Markdown formatting, syntax, and structure with Python scripts and linters.

Community
Intermediate