guide-builder

Automate Markdown-based GitHub Pages guide creation and maintenance workflows.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/fukukei23/claude-config --skill guide-builder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: guide-builder
Source: https://github.com/fukukei23/claude-config/tree/main/.claude/worktrees/make-song-analyze-song-bridge/skills/guide-builder
Command: npx skills add https://github.com/fukukei23/claude-config --skill guide-builder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the challenge of manually creating and maintaining polished GitHub Pages documentation sites by automating the workflow from Markdown source files to published guide websites.

Core Features & Use Cases

  • Guide Site Generation: Creates a complete mobile-friendly GitHub Pages guide structure with source chapters, generated pages, styling, and build tooling.
  • Chapter Management: Adds new documentation chapters to existing guides while updating navigation, metadata, tests, and published output.
  • Use Case: A documentation maintainer can use this Skill to launch a new technical guide or extend an existing knowledge base with consistently formatted chapters.

Quick Start

Use the guide-builder skill to create a new GitHub Pages guide from my Markdown documentation.

Frequently Asked Questions about guide-builder

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

FAQPage Schema
How do I automate creating a GitHub Pages guide from Markdown files?

Automating GitHub Pages guide creation involves generating a complete site structure from Markdown source files, including styling and build tooling. This converts your raw documentation into a mobile-friendly, published website automatically.

What is the best way to add new chapters to an existing Markdown documentation site?

The best way to add chapters to a Markdown documentation site is using an automated guide builder that updates navigation, metadata, and tests simultaneously. This ensures the HTML conversion and published output remain consistently formatted.

Do I need structured source directories to generate a Markdown guide website?

Yes, you need structured source directories to generate a Markdown guide website. The conversion tooling, validation steps, and GitHub Pages deployment configuration all rely on properly organized Markdown inputs to build a functional guide.

Does GitHub Pages support automated HTML conversion and testing workflows?

GitHub Pages supports automated HTML conversion and testing workflows through configured build tooling. By applying validation steps and deployment configuration, your Markdown source files are systematically converted, tested, and published as a guide website.

Why does my Markdown to HTML conversion break during GitHub Pages deployment?

Markdown to HTML conversion breaks during GitHub Pages deployment when structured source directories are misconfigured or validation steps fail. Using an automated guide builder enforces consistent formatting and testing workflows to prevent these publishing errors.