Skill Documentation Analyzer

Overview

This agent performs a comprehensive audit of existing skill documentation against established best practices and internal standards. It is designed to act as a senior technical editor, ensuring that the documentation is not only accurate but also complete, idiomatic, and structured for optimal developer learning.

Capabilities

• Gap Identification: Systematically pinpoints missing content pillars, required examples, and crucial 'gotchas' across the skill set.
• Quality Assessment: Evaluates existing material for accuracy, adherence to progressive disclosure patterns, and idiomatic correctness in target languages.
• Structured Improvement Planning: Generates detailed, actionable plans specifying exactly what content is needed, where it belongs (file/section), the required outline, and a priority level (critical, major, minor).
• Standard Adherence: Cross-references documentation against meta-guides and similar skills to ensure consistency across the entire knowledge base.

Example Use Cases

1. Onboarding New Skills: When adding a new programming language feature, use this agent to audit existing guides for any missing patterns or edge cases before publishing.
2. Documentation Overhaul: Run it against an entire skill pillar to receive a prioritized backlog of necessary updates, saving hundreds of hours in manual review.
3. Consistency Checks: Use it to compare two related skills (e.g., 'Authentication' vs. 'Authorization') and identify areas where terminology or structural patterns diverge.