skills.rest
j5ik2o
j5ik2oCOMMUNITY
Explore all skills by this author →
Website𝕏@j5ik2oGitHub

reviewing-skills

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

3|1|Updated Oct 31, 2025
Search Tags:#reporting#best-practices#quality-assurance#SKILL.md#skill-review#documentation-quality#workflow-analysis
One-click install
npx skills add https://github.com/j5ik2o/cqrs-es-spec-kit-js --skill reviewing-skills-j5ik2o
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reviewing-skills
Source: https://github.com/j5ik2o/cqrs-es-spec-kit-js/tree/main/.claude/skills/reviewing-skills
Command: npx skills add https://github.com/j5ik2o/cqrs-es-spec-kit-js --skill reviewing-skills-j5ik2o

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured approach to reviewing Claude Code skills for quality and alignment with documented best practices. It helps ensure SKILL.md entries are complete, well-formed, and easy to audit.

Core Features & Use Cases

  • Best-practice conformance: Validates frontmatter completeness (name and description) and body structure against the best-practices checklist.
  • Quality reporting: Generates a concise review report highlighting critical issues, recommended improvements, and optional enhancements.
  • Reusability: Uses references/best-practices.md to guide checks and can be applied to any Skill unit in the repository.

Quick Start

Run this skill on a target SKILL.md to perform a standards-aligned review, referencing references/best-practices.md for validation criteria.

Frequently Asked Questions about reviewing-skills

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

FAQPage Schema
How do I check if my SKILL.md documentation follows best practices?▼

To check if your SKILL.md follows best practices, provide its file path to this reviewer, which validates frontmatter and body structure against a best-practices checklist and outputs an actionable report.

What is the best way to review a Claude Code skill for quality assurance?▼

The best way to review a Claude Code skill for quality assurance is to validate its SKILL.md frontmatter completeness and body structure against a documented best-practices checklist to identify documentation gaps.

How does a SKILL.md review report help improve documentation quality?▼

A SKILL.md review report improves documentation quality by highlighting critical issues, recommended improvements, and optional enhancements based on standardized validation criteria.

Can I use this skill review tool on any SKILL.md file in my repository?▼

Yes, you can use this skill review tool on any SKILL.md file in your repository by providing the target file path and utilizing the referenced best-practices checklist for validation criteria.

What do I need to provide to run a skill review for standards alignment?▼

To run a skill review for standards alignment, you need to provide the file path to the target SKILL.md so the reviewer can apply the referenced best-practices checklist to generate a structured report.

Related Skills

Explore More Content & Communication Skills→
brave-experimentsbrave-experiments
1

fix-bp-docs

Audit and correct best practices markdown for stale references and duplicates.

Official
Advanced
simonheimlichersimonheimlicher
1

auditing-skills

Audit SKILL.md frontmatter, XML structure, and content quality against official guidelines.

Community
Advanced
sumilee-pcusumilee-pcu

skill-test

Validate AI skill structural integrity and behavioral compliance via static analysis.

Community
Advanced
inakaminakam

reviewing-skills

Reviews SKILL.md files for standards compliance and actionable improvements.

Community
Advanced