skills.rest
asakuno
asakunoCOMMUNITY
Explore all skills by this author →
GitHub

reviewing-skills

Review SKILL.md files against official best-practices and generate a conformity report.

Updated Dec 29, 2025
Search Tags:#linting#documentation#review#best-practices#quality-assurance#skill#frontmatter
One-click install
npx skills add https://github.com/asakuno/template-repository --skill reviewing-skills-asakuno
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reviewing-skills
Source: https://github.com/asakuno/template-repository/tree/main/.claude/skills/reviewing-skills
Command: npx skills add https://github.com/asakuno/template-repository --skill reviewing-skills-asakuno

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams evaluate Claude Code skills by comparing SKILL.md files to the official best-practices checklist, surfacing quality gaps and structural issues.

Core Features & Use Cases

  • Check frontmatter validity (name, description) and body structure against best practices
  • Generate a conformity report highlighting Critical, Warning, and Info issues
  • Assist with iterative improvements by providing actionable recommendations

Quick Start

Run the review workflow on a target SKILL.md to generate a gap analysis against best practices

Frequently Asked Questions about reviewing-skills

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

FAQPage Schema
How do I review Claude Code skills against best practices?▼

You can review skills by analyzing individual SKILL.md files and their surrounding structure against best practices, producing a structured report that highlights quality gaps and actionable recommendations.

What is a SKILL.md frontmatter conformity report?▼

A SKILL.md frontmatter conformity report is a structured document that identifies quality issues by checking frontmatter validity and body structure against official best-practices, categorizing findings into critical, warning, and info issues.

How do I check if my skill documentation follows quality assurance standards?▼

Check skill documentation quality by running a review workflow that assesses the SKILL.md frontmatter and body against a best-practices checklist, surfacing structural issues and providing iterative improvement recommendations.

Can I use a linting workflow to validate SKILL.md structure?▼

Yes, you can validate SKILL.md structure by applying a linting review process that checks frontmatter validity and body conformity against best practices, generating a gap analysis to guide iterative improvements.

What files do I need to run a skill quality review?▼

To run a skill quality review, you need access to the SKILL.md frontmatter, the skill body content, and the references/best-practices.md file to accurately compare and identify structural conformity issues.

What are the limitations of automated skill reviews?▼

Automated skill reviews are limited to assessing structural conformity and frontmatter validity against a best-practices checklist, identifying critical and warning issues but not evaluating the actual execution logic or runtime behavior of the skill.

Related Skills

Explore More Software Engineering Skills→
j5ik2oj5ik2o
3

reviewing-skills

Inspects SKILL.md files against a best-practices checklist and reports gaps and improvements.

Community
Basic
thimsluggathimslugga

skill-judge

Evaluate SKILL.md files across eight quality dimensions and return structured reports.

Community
Advanced
yuhle-qugyuhle-qug

documentation-expert

Diagnose documentation structure, cohesion, and discoverability problems.

Community
Basic
WladimirfnWladimirfn

skill-check

Validate SKILL.md files against the agentskills specification and best practices.

Community
Advanced