skill-enhancer

Enhance SKILL.md files with code examples, quick references, and FAQs.

175|26|Updated Aug 14, 2025
One-click install
npx skills add https://github.com/jmagly/ai-writing-guide --skill skill-enhancer-jmagly
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-enhancer
Source: https://github.com/jmagly/ai-writing-guide/tree/main/.factory/skills/skill-enhancer
Command: npx skills add https://github.com/jmagly/ai-writing-guide --skill skill-enhancer-jmagly

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires skill-builder, and includes references (resource) components.

What problem does it solve?

This Skill eliminates basic skill quality by automatically enhancing SKILL.md files using AI to extract better examples, create comprehensive guides, and improve overall skill quality.

Quick Start

Use this Skill to automatically transform basic skill templates into comprehensive, high-quality skill documentation.

Example Output

"Skill Enhancement Complete

Before Enhancement:

  • SKILL.md lines: ~75
  • Code examples: 0-2
  • Sections: 3-5

After Enhancement:

  • SKILL.md lines: ~300-500
  • Code examples: 5-10
  • Quick reference: Comprehensive
  • FAQ: 5-10 questions

Quality Metrics:

  • Code examples: 0-2 → 5-10
  • Sections: 3-5 → 8-12

Enhanced sections include practical code examples, comprehensive quick reference, and FAQ based on common questions from documentation sources."

Frequently Asked Questions about skill-enhancer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I improve SKILL.md documentation quality automatically?

Use skill-enhancer to transform basic SKILL.md templates into comprehensive guides by analyzing references, adding practical code examples, creating quick references, and generating FAQs. The Skill backs up your original file, applies AI-powered enhancement, and verifies against source references before completion.

What gets added when I enhance a skill guide?

Enhancement expands SKILL.md from 75 lines to 300-500 lines, adding 5-10 code examples, 8-12 sections, comprehensive quick references, and 5-10 FAQ questions. Content includes key concepts, patterns, practical workflows, and hallucination checks grounded in source material.

Can I use skill-enhancer with my existing SKILL.md files?

Yes. Skill-enhancer works with local SKILL.md files or API-assisted workflows. It creates a backup automatically, applies multi-mode enhancement (local, API, or manual), performs quality verification, and provides rollback protocols if you need to recover the original version.

Does skill-enhancer require skill-builder as a dependency?

Yes, skill-builder is required. Skill-enhancer builds on skill-builder's foundational templating to enhance and expand SKILL.md documentation with references, code examples, and structured guidance that transforms basic templates into production-ready guides.

How does skill-enhancer prevent hallucinations in generated content?

The Skill verifies all enhanced content against source references during processing. Quality checks ensure code examples, concepts, and FAQs remain grounded in actual documentation sources rather than generating unsupported claims.

What happens if I need to revert an enhancement?

Skill-enhancer maintains a backup of your original SKILL.md and includes rollback protocols. You can recover your original file at any point if the enhancement doesn't meet your needs.