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.