skill-introductionlisted

Generate a beautiful, deployable HTML introduction page for any AgentSkill. Reads USAGE.md (preferred) or SKILL.md, parses name, description, and feature sections, then renders a polished page with a hero section, feature cards, quick start, command examples, collapsible doc cards, side navigation, and a floating install button. Supports 4 themes: light (default), aurora (dark glass), techblue (debug-tool style), finance (dark blue + gold). Optionally deploys via a pluggable hook so re-runs update the same URL. Use when the user says "generate a skill intro page", "make a doc page for this skill", "publish this skill's docs", "skill-introduction". If the user does not specify a target skill, ask them for the skill name or directory path.
Songhonglei/build-better-skills · ★ 1 · AI & Automation · score 74

Install: claude install-skill Songhonglei/build-better-skills

# skill-introduction - **Version**: 1.0.1 - **License**: MIT - **Author**: Evan Song · [github.com/Songhonglei](https://github.com/Songhonglei) - **Repository**: https://github.com/Songhonglei/skill-introduction Auto-generate a polished HTML introduction page from a skill's `USAGE.md` or `SKILL.md`. Four themes, optional deploy hook, re-runs update the same URL. ## Quick Start ### Generate only (no deploy) ```bash python3 scripts/generate_html.py --skill-dir <path-to-skill> --no-deploy ``` Outputs to `./output/<slug>-intro.html` (override with `--output`). ### Specify author ```bash python3 scripts/generate_html.py --skill-dir <path> --author "Jane Doe" ``` Author resolution order: `--author` → `SKILL_INTRO_AUTHOR` env → `git config --global user.name` → `$USER`. ### Pick a theme ```bash python3 scripts/generate_html.py --skill-dir <path> --theme aurora ``` Themes: `light` (default), `aurora` (dark glass), `techblue` (debug-tool), `finance` (dark blue + gold). ### Use a specific source file ```bash python3 scripts/generate_html.py --skill-dir <path> --source USAGE.md ``` Default resolution: `--source` > `USAGE.md` > `SKILL.md` (fallback with notice). ### Custom subtitle (recommended) ```bash python3 scripts/generate_html.py --skill-dir <path> \ --subtitle "Beautiful, deployable HTML docs for your skill" ``` Without `--subtitle`, the page truncates the long `description` field — usually ugly. Always pass a one-liner. ## Generated Page Layout | Region | Co