audit-skill-type

Analyze SKILL.md files and recommend skill or command implementation.

1|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/mattbobambrose/mattbobambrose-claude-skills --skill audit-skill-type
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audit-skill-type
Source: https://github.com/mattbobambrose/mattbobambrose-claude-skills/tree/main/plugins/project-tools/skills/audit-skill-type
Command: npx skills add https://github.com/mattbobambrose/mattbobambrose-claude-skills --skill audit-skill-type

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many marketplace items are ambiguous between full-featured Skills and lightweight Commands, causing mismatched implementations and poor UX; this Skill provides a systematic audit to recommend the appropriate type for each plugin entry.

Core Features & Use Cases

  • Automated discovery: Glob and read every SKILL.md under plugins to collect metadata and workflow descriptions.
  • Signal-based evaluation: Count steps, examine allowed-tools, assess context needs and output complexity, and check for bundled resources to score each item.
  • Actionable report: Produce a recommendation table with Skill/Command decisions, confidence levels, and concise reasoning for maintainers and marketplace curators.

Quick Start

Run the audit to analyze all plugins and produce a recommendation table classifying each SKILL.md as a skill or a command.

Frequently Asked Questions about audit-skill-type

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

FAQPage Schema
How do I determine if a marketplace plugin should be a skill or a command?

To determine if a marketplace plugin should be a skill or a command, analyze its SKILL.md file to count workflow steps, evaluate allowed-tools, assess context needs, and score output complexity.

What is the difference between a skill and a command in a plugin marketplace?

The difference between a skill and a command involves workflow depth; skills require richer context and multi-step processing, while commands are lightweight executables suited for simpler output complexity and fewer tool requirements.

How do I audit plugin SKILL.md files for proper classification?

You audit plugin SKILL.md files by globbing the plugins directory to parse YAML frontmatter, evaluating bundled resources, and generating a recommendation table with confidence levels for each item.

What metrics are used to evaluate whether a plugin needs richer context?

Metrics used to evaluate whether a plugin needs richer context include the count of workflow steps, the allowed-tools specified, output complexity, and the presence of bundled resources within the SKILL.md metadata.

Can I automate the classification of marketplace items as skills or commands?

Yes, you can automate the classification of marketplace items by systematically reading every SKILL.md to apply signal-based evaluation, producing actionable recommendations for maintainers and marketplace curators.

When should I not use a skill classification for a marketplace plugin?

You should not use a skill classification when a plugin lacks multi-step workflows, requires minimal allowed-tools, or produces low output complexity, indicating a lightweight command is the appropriate implementation.