plan-to-html

Convert Markdown plans into self-contained styled HTML documents.

1|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/ohnotnow/agentic-stuff --skill plan-to-html
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-to-html
Source: https://github.com/ohnotnow/agentic-stuff/tree/main/skills/plan-to-html
Command: npx skills add https://github.com/ohnotnow/agentic-stuff --skill plan-to-html

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires markdown>=3.5, pymdown-extensions>=10.0, and includes scripts (resource) components.

What problem does it solve?

Convert a markdown plan (Claude plan-mode output, design doc, ait issue body, etc.) into a single self-contained, regular-user-friendly HTML file styled with the local design system. Use when the user wants to share a plan with non-technical stakeholders, send it for review, attach it to an email, or print it.

Core Features & Use Cases

  • Single-file HTML output that embeds the local design system CSS for consistent branding and offline viewing.
  • Converts plan-mode markdown into a readable, printer-friendly document suitable for non-technical audiences and executives.
  • Automatically extracts the plan title, includes metadata (date, author), and supports an optional "Background" preamble for context.

Quick Start

Run the plan-to-html script on your Markdown plan file to produce a polished HTML document.

Frequently Asked Questions about plan-to-html

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

FAQPage Schema
How do I convert a markdown plan into a shareable HTML document for non-technical stakeholders?

To convert a markdown plan into a shareable HTML document, use this tool to render the markdown and embed the local design system CSS. It outputs a single self-contained HTML file with a header containing the title, date, and author for offline viewing and email sharing.

What is the best way to share Claude plan-mode markdown outputs with executives?

The best way to share Claude plan-mode markdown outputs with executives is converting them into a styled HTML file. This tool transforms the markdown into a printer-friendly document with consistent branding, making it readable for non-technical audiences and review workflows.

Do I need the pymdown-extensions package to convert markdown to HTML?

Yes, you need the pymdown-extensions package (version 10.0 or higher) along with the markdown package (version 3.5 or higher) installed. These dependencies are required to process the markdown syntax and generate the styled HTML document.

Can I add a background section when converting a design doc markdown to HTML?

Yes, you can add a background section when converting a design doc markdown to HTML. The tool supports an optional Background preamble to provide context, automatically extracting the title and including metadata like date and author in the output header.

Does the generated HTML file require external CSS files for styling?

No, the generated HTML file does not require external CSS files for styling. The tool embeds the local design system CSS directly into the single HTML output, ensuring consistent branding and allowing offline viewing without external dependencies.