skill-builder

Transform extracted documentation into Claude skill packages with SKILL.md and references.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

πŸ’‘ This Skill requires doc-scraper, pdf-extractor, and includes references (resource) components.

What problem does it solve?

This Skill eliminates the manual effort of building skills by automatically transforming extracted documentation into properly structured Claude skill packages ready for upload.

Quick Start

Use this Skill after doc-scraper/pdf-extractor to automatically generate uploadable skill packages from documentation sources.

Example Output

"Skill Build Complete

Generated:

  • SKILL.md with comprehensive documentation
  • References/ directory with categorized content
  • Code examples extracted from source documentation

Output: output/<skill-name>/ with complete skill structure: β”œβ”€β”€ SKILL.md β”œβ”€β”€ references/ β”‚ β”œβ”€β”€ index.md β”‚ β”œβ”€β”€ getting_started.md

  • API reference with practical examples
  • Navigation table linking all reference files"

Frequently Asked Questions about skill-builder

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

FAQPage Schema
How do I automatically transform documentation into Claude skill packages?β–Ό

Skill-builder transforms extracted documentation into structured Claude skill packages ready for upload. It takes JSON pages or markdown content from doc-scraper or pdf-extractor as input and generates a complete skill directory with SKILL.md, categorized references, and code examples, eliminating manual packaging work.

What documentation formats does skill-builder accept as input?β–Ό

Skill-builder accepts JSON pages and markdown content extracted by doc-scraper or pdf-extractor. It validates input format recognition, enforces lowercase alphanumeric naming conventions with hyphens, and structures output as standardized Claude skill layouts for deployment.

Can I use skill-builder without running doc-scraper or pdf-extractor first?β–Ό

No. Skill-builder requires extracted documentation from doc-scraper or pdf-extractor as prerequisites. It enforces input validation to confirm documentation exists and is in recognized formats before generating the skill package structure.

What does skill-builder output after processing documentation?β–Ό

Skill-builder generates a complete skill directory with SKILL.md containing comprehensive documentation, a references/ subdirectory with categorized markdown files organized by topic, extracted code examples from source material, and an index linking all reference files for navigation.

How does skill-builder handle reference organization and quality?β–Ό

Skill-builder performs template-driven SKILL.md generation, categorizes references into organized markdown files, and applies quality checks to enforce naming conventions and output structure consistency across generated skill packages.

What naming rules does skill-builder enforce for skill packages?β–Ό

Skill-builder enforces lowercase alphanumeric naming conventions with hyphens for skill packages and enforces standardized output structure including SKILL.md, references directories, and optional assets to ensure consistent deployment-ready formatting.