command-audit

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.