command-audit

Audit command files for delegation clarity, simplicity, and argument handling.

13|Updated Dec 31, 2025
One-click install
npx skills add https://github.com/philoserf/claude-code-setup --skill command-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: command-audit
Source: https://github.com/philoserf/claude-code-setup/tree/main/skills/command-audit
Command: npx skills add https://github.com/philoserf/claude-code-setup --skill command-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured approach to auditing commands to ensure they delegate to a single agent or skill, stay simple, properly handle arguments, and maintain documentation proportional to complexity. It helps auditors identify when a command is overly complex, ensure explicit delegation targets, and verify that user input is passed through correctly.

Core Features & Use Cases

  • Delegation clarity validation: ensure the command explicitly names an agent or skill and uses a clear invocation pattern
  • Simplicity enforcement: detect when a command exceeds simple delegation boundaries (6-80 lines) or contains if/else logic that should live in a skill
  • Argument handling: confirm user-provided arguments are passed to the delegated target via $ARGUMENTS or positional parameters
  • Documentation proportionality: verify frontmatter and body documentation match the command's complexity
  • Decision guidance: provide recommendations on whether the wrapper should stay a command or migrate to a dedicated skill

Quick Start

Example: run a quick audit on a sample command like commands/validate-agent.md to generate a concise report and suggested improvements.