skill-review

Audit SKILL.md files and produce section-by-section verdicts with suggested changes.

Updated Oct 19, 2025
One-click install
npx skills add https://github.com/igor1309/skills --skill skill-review-igor1309
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-review
Source: https://github.com/igor1309/skills/tree/main/skill-review
Command: npx skills add https://github.com/igor1309/skills --skill skill-review-igor1309

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The skill-review Skill helps authors and maintainers detect low-signal, misleading, or fragile content in SKILL.md files so agents use skill libraries effectively without wasting context or making incorrect assumptions.

Core Features & Use Cases

  • Section-by-section auditing: Labels each section as signal, noise, or ask user with concrete reasons tied to redundancy, domain knowledge, or actionable value.
  • Quality criteria and guardrails: Evaluates description quality, degrees of freedom, progressive disclosure, practical effectiveness, and staleness with a strict rubric.
  • Use Case: Run this Skill to audit a collection of SKILL.md files before publishing a shared skills registry or when triaging noisy agent behaviors caused by poor skill descriptions.

Quick Start

Audit the provided SKILL.md and return a section-by-section verdict, strengths, and specific edit suggestions using the skill-review rubric.

Frequently Asked Questions about skill-review

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

FAQPage Schema
How do I audit SKILL.md files for low-signal or misleading content?

Auditing SKILL.md files involves running a section-by-section review that labels content as signal, noise, or ask user, producing a structured verdict with strengths and concrete suggested changes.

What makes a Claude Code skill description high quality?

A high-quality Claude Code skill description avoids low-signal content, maintains appropriate degrees of freedom, follows progressive disclosure, and provides actionable value without misleading agent assumptions.

How do I detect noisy or redundant sections in a SKILL.md file?

Detecting noisy sections in a SKILL.md file requires evaluating each section against domain knowledge and actionable value criteria, labeling them as signal, noise, or ask user with concrete reasons.

Can I review multiple SKILL.md files in a collection before publishing?

Yes, you can run a content audit across a collection of SKILL.md files before publishing a shared skills registry, verifying staleness and description quality across the entire skill library.

What format does a SKILL.md file need to be reviewed properly?

A SKILL.md file requires YAML frontmatter including name and description fields to be reviewed properly, ensuring the skill-review process can evaluate description quality and degrees of freedom.

When should I run a skill quality audit on my agent skills?

You should run a skill quality audit when triaging noisy agent behaviors caused by poor skill descriptions or before publishing a shared skills registry to ensure agents use skill libraries effectively.