reviewing-skills

Audit Claude Code SKILL.md files against official best practices and output structured reports.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/mgr-kb/mgr-dotfiles --skill reviewing-skills-mgr-kb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reviewing-skills
Source: https://github.com/mgr-kb/mgr-dotfiles/tree/main/claude/skills/reviewing-skills
Command: npx skills add https://github.com/mgr-kb/mgr-dotfiles --skill reviewing-skills-mgr-kb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured audit of Claude Code skills against official best practices, enabling consistent quality checks and actionable improvement recommendations.

Core Features & Use Cases

  • Reviews the SKILL.md frontmatter and body for completeness and structure.
  • Checks alignment with references/best-practices and validates workflow quality and content quality.
  • Use Case: As a reviewer, run this skill to produce a remediation plan for any skill that deviates from the standard and to generate a validation checklist.

Quick Start

Run the reviewer on the target skill by providing its SKILL.md path (for example, claude/skills/reviewing-skills/SKILL.md). Then review results are produced as a structured report you can act on.

Frequently Asked Questions about reviewing-skills

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

FAQPage Schema
How do I validate a Claude Code skill against best practices?

To validate a Claude Code skill, provide its SKILL.md path for a structured audit. The review evaluates frontmatter, body structure, references, and scripts, then outputs an actionable remediation plan and validation checklist.

What is included in a SKILL.md quality review?

A SKILL.md quality review evaluates frontmatter completeness, body structure, references, scripts, and overall content quality. It validates compliance against official best-practices checklists and reports structured, actionable improvements for remediation.

How do I check if my skill documentation meets the required structure?

You check skill documentation structure by running a validation review on the SKILL.md file. This process analyzes frontmatter formatting, body organization, and references to ensure alignment with official best-practices and generates a compliance report.

Can I generate a remediation checklist for a Claude Code skill?

Yes, you can generate a remediation checklist by running a skill review on the target SKILL.md. The audit identifies deviations from best practices across defined categories and outputs a structured validation checklist ready for actionable improvements.

What is the best way to lint a Claude Code skill for compliance?

The best way to lint a Claude Code skill is to audit its SKILL.md against official best practices. This skill-quality review evaluates documentation structure, references, and scripts, producing a structured report with actionable improvements for remediation.

Do I need any dependencies to review a Claude Code skill?

No dependencies are required to review a Claude Code skill. You only need to provide the path to the target SKILL.md file, and the review process evaluates its frontmatter, body, references, and scripts to produce a structured remediation report.