skill-enhancer_skill

Overview

This skill enhances basic skill documentation by using AI to extract examples, expand guides, and raise overall quality. It turns terse templates into comprehensive, navigable skill files while preserving original content through automatic backups. The goal is reproducible, grounded enhancements with clear validation and rollback steps.

How this skill works

The enhancer analyzes the skill directory and its reference files, identifies code samples, patterns, and gaps, then produces an expanded skill document with practical examples, quick reference, best practices, and FAQ. It requires a backup of the original file, supports local or API-driven modes, and records checkpoints for audit and recovery. Validation steps compare before/after content and verify examples against references to avoid invented material.

When to use it

• You have a minimal or template-level skill file that needs comprehensive documentation.
• Reference documents contain useful examples but lack a consolidated quick reference or FAQ.
• Preparing a skill for publication or internal handoff where clarity and examples matter.
• When you want automated enhancement while ensuring no new features are invented.
• Recovering or improving older skills to meet quality metrics (examples, sections, length).

Best practices

• Always create and verify a backup before running enhancements.
• Ensure reference files contain substantive content and code snippets to extract.
• Choose local mode for cost-free, faster runs; use API mode when integration is needed.
• Escalate to the user when source quality is low or multiple enhancement directions exist.
• Validate examples by spot-checking they appear verbatim in reference files.

Example use cases

• Upgrade a one-page skill template into a 200–400 line document with 5–10 code examples.
• Extract practical code snippets from multiple reference files into a single quick reference.
• Generate an FAQ from recurring questions and edge cases found in project docs.
• Run incremental enhancements on large projects by processing sections separately to avoid timeouts.
• Recover from a poor enhancement by restoring the backup and retrying with stricter prompts.