suite-audit_skill

This skill analyzes a plugin suite with subagents to identify usability improvements, gaps, duplicates, and workflow optimizations, delivering prioritized,

Python

19

GitHub Stars

1

Bundled Files

2 months ago

Catalog Refreshed

4 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill greyhaven-ai/claude-code-config --skill suite-audit

SKILL.md11.1 KB

Overview

This skill performs meta-level audits of plugin suites using coordinated subagents to find usability problems, coverage gaps, duplication, and workflow inefficiencies. It produces a prioritized, evidence-backed report and can convert approved recommendations into actionable todos. The auditor is designed for systematic, repeatable evaluations across agent repositories.

How this skill works

The skill runs four focused analysis passes—Usability, Gap, Duplication, and Workflow—via subagents that inspect agent definitions, commands, and metadata. It synthesizes scores, concrete findings, and recommended fixes into a single audit report and then asks the user which recommendations to convert into todos with category, priority, and effort estimates.

When to use it

Perform a full suite audit before a major release or roadmap planning
Run targeted usability reviews for a subset of agents
Identify missing agents and recommend new capabilities for a domain
Find and consolidate duplicated or overlapping agents
Optimize agent handoffs and multi-agent workflows

Best practices

Start with a technical linting pass (structure/frontmatter) before strategic auditing
Provide plugin.json and a complete agents/skills inventory for accurate analysis
Approve conversion choices to control which recommendations become todos
Prioritize fixes by impact and maintenance cost in the report
Require evidence (file quotes and locations) for high-impact recommendations

Example use cases

Full audit of a creative-writing plugin suite to produce roadmap and todos
Usability-only review of testing agents to improve discoverability and examples
Gap analysis for an observability plugin to recommend new specialized agents
Duplication check in a knowledge-base plugin and consolidation plan
Workflow optimization to define clear handoffs for a multi-agent document processing chain

FAQ

A consolidated audit report with scores, detailed findings per analysis phase, prioritized recommendations, suggested new agents, consolidation targets, and an option to convert chosen items into todos.

How are priorities and effort estimated?

Recommendations include a simple priority tag (Critical/Important/Nice to Have) and an estimated effort (Low/Med/High) based on consolidation complexity and changes required to agents or integrations.

Can I run only parts of the audit?

Yes. You can request any combination of the four passes (Usability, Gap, Duplication, Workflow) for a targeted review.

What evidence backs recommendations?

Findings cite agent file locations, short quotes, and clear criteria so recommendations are traceable and actionable.