review-skills

Audit skill libraries for duplicates, broken references, and circular dependencies.

5|Updated Jul 25, 2025
One-click install
npx skills add https://github.com/tomzx/agents --skill review-skills-tomzx
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: review-skills
Source: https://github.com/tomzx/agents/tree/main/skills/review-skills
Command: npx skills add https://github.com/tomzx/agents --skill review-skills-tomzx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audits a directory of skills to identify quality issues such as duplicates, broken references, circular dependencies, orphaned skills, composability problems, and skill gaps.

Core Features & Use Cases

  • Detect duplicates by name, description, or content across SKILL.md files.
  • Find broken references to other skills, files, tools, or external URLs.
  • Identify circular dependencies and orphaned skills to improve maintainability.
  • Assess composability across skills and surface potential integration risks.
  • Generate prioritized remediation guidance to strengthen a skills library for reliable automation.

Quick Start

Run the audit against a skills directory (containing SKILL.md files) to surface issues and recommended fixes.

Frequently Asked Questions about review-skills

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

FAQPage Schema
How do I audit a skill library for duplicates and broken references?▼

To audit a skill library, run this tool against a directory containing SKILL.md files to detect duplicates, broken references, and generate a structured health report.

What is a circular dependency in a skills directory?▼

A circular dependency in skills occurs when components reference each other in a loop, which this audit identifies alongside orphaned skills to improve library maintainability.

Can I check for orphaned skills and composability gaps in SKILL.md files?▼

Yes, you can assess composability across SKILL.md files to surface integration risks, identify orphaned skills, and generate prioritized remediation steps for library growth.

What's the best way to maintain a skills library for reliable automation?▼

The best way to maintain a skills library is to audit it regularly to identify quality issues, applying the prioritized remediation guidance to strengthen automation reliability.

Does the skills audit require external dependencies to run?▼

No, the skills audit operates without external dependencies, directly scanning directories to output a structured health report suitable for product decisions and library governance.

Why are my skill references broken and how do I fix them?▼

Broken references happen when skills link to missing files or URLs, which this audit detects and resolves by generating a prioritized report with specific remediation steps.