improve-skill

To audit code documentation for clarity and completeness, this skill analyzes existing markdown and README files, identifies ambiguous instructions, and refines the text to ensure quality standards are met automatically.

Refactoring AI tools and scripts after complex interactions is best handled by reflecting on recent work to optimize configuration files, updating tooling for reliability, and preventing future confusion through automated validation.

Yes, you can target documentation enhancement to a specific focus area by providing an optional focus area argument, allowing the skill to concentrate refinement efforts on specific agent definitions or markdown files.

Self-improvement tooling requires no external dependencies to validate quality standards, relying entirely on built-in automated validation and manual checks to ensure skill markdown and scripts adhere to completeness criteria.

Skill auditing focuses on clarity, conciseness, and completeness because these qualities ensure a more efficient user experience, reducing ambiguity in agent definitions and improving the reliability of the AI's tools.

You should avoid using automated refactoring for skill markdown when manual review is necessary to assess nuanced context, although the skill still provides validation checks to ensure basic quality standards are maintained.