How do I install the HTML Docs skill?

Run npx skillmds@latest add aojdevstudio/html-docs in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is HTML Docs safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with HTML Docs?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is HTML Docs free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published HTML Docs?

aojdevstudio (@aojdevstudio) published this skill. Their other Agent Skills are listed on their SkillMD profile.

HTML Docs by aojdevstudio — Agent Skill

Name: HTML Docs
Author: aojdevstudio

HTML Docs

Convert Markdown plans, reports, PR writeups, research docs, or general Markdown files into polished standalone adjacent HTML files. Use when the user asks to port, render, convert, beautify, or make a Markdown doc into HTML.

aojdevstudio 609a8ab 5 files · 8.3 KB Updated Sep 17, 2026

File contents

HTML Docs

Use this skill to turn a Markdown document into a browser-readable HTML artifact. The output must be a single self-contained .html file written beside the source document:

docs/VISION.md -> docs/VISION.html

Workflow

Resolve the target Markdown file. Use an absolute path when possible.
Inspect enough of the source document to understand the doc type: plan, report, PR writeup, research, or general.
Run the converter from the installed plugin root:

PLUGIN_ROOT="${CODEX_PLUGIN_ROOT:-$HOME/plugins/html-docs}"
python3 "$PLUGIN_ROOT/scripts/markdown_to_html.py" /absolute/path/to/doc.md

If the adjacent HTML file already exists, do not overwrite it unless the user asked to regenerate or replace it. Then run:

PLUGIN_ROOT="${CODEX_PLUGIN_ROOT:-$HOME/plugins/html-docs}"
python3 "$PLUGIN_ROOT/scripts/markdown_to_html.py" /absolute/path/to/doc.md --force

Report the generated .html path. If a browser tool is available and the user wants visual verification, open the file directly.

Output Rules

Write beside the source Markdown file, never into a new output directory.
Keep the artifact self-contained: no CDN, no remote CSS, no remote JavaScript, no build step.
Preserve code blocks, tables, task lists, links, headings, and source structure.
Prefer the converter's deterministic output for repeatable docs. For a bespoke artifact, first create or revise the Markdown into the desired structure, then run the converter.
For local images, the converter inlines reasonably sized files as data URIs. Remote images are rendered as explicit asset references so the HTML remains dependency-free.

Useful Commands

Convert with automatic doc-type detection:

python3 "$HOME/plugins/html-docs/scripts/markdown_to_html.py" ./docs/VISION.md

Force a specific doc type:

python3 "$HOME/plugins/html-docs/scripts/markdown_to_html.py" ./docs/PR.md --doc-type pr --force

Verify bundled fixtures:

python3 "$HOME/plugins/html-docs/scripts/verify_fixtures.py"

Fixture examples live at references/fixtures/*.md.

---name: html-docsdescription: Convert Markdown plans, reports, PR writeups, research docs, or general Markdown files into polished standalone adjacent HTML files. Use when the user asks to port, render, convert, beautify, or make a Markdown doc into HTML.---# HTML DocsUse this skill to turn a Markdown document into a browser-readable HTML artifact. The output must be a single self-contained `.html` file written beside the source document:```textdocs/VISION.md -> docs/VISION.html```## Workflow1. Resolve the target Markdown file. Use an absolute path when possible.2. Inspect enough of the source document to understand the doc type: plan, report, PR writeup, research, or general.3. Run the converter from the installed plugin root:```bashPLUGIN_ROOT="${CODEX_PLUGIN_ROOT:-$HOME/plugins/html-docs}"python3 "$PLUGIN_ROOT/scripts/markdown_to_html.py" /absolute/path/to/doc.md```4. If the adjacent HTML file already exists, do not overwrite it unless the user asked to regenerate or replace it. Then run:```bashPLUGIN_ROOT="${CODEX_PLUGIN_ROOT:-$HOME/plugins/html-docs}"python3 "$PLUGIN_ROOT/scripts/markdown_to_html.py" /absolute/path/to/doc.md --force```5. Report the generated `.html` path. If a browser tool is available and the user wants visual verification, open the file directly.## Output Rules- Write beside the source Markdown file, never into a new output directory.- Keep the artifact self-contained: no CDN, no remote CSS, no remote JavaScript, no build step.- Preserve code blocks, tables, task lists, links, headings, and source structure.- Prefer the converter's deterministic output for repeatable docs. For a bespoke artifact, first create or revise the Markdown into the desired structure, then run the converter.- For local images, the converter inlines reasonably sized files as data URIs. Remote images are rendered as explicit asset references so the HTML remains dependency-free.## Useful CommandsConvert with automatic doc-type detection:```bashpython3 "$HOME/plugins/html-docs/scripts/markdown_to_html.py" ./docs/VISION.md```Force a specific doc type:```bashpython3 "$HOME/plugins/html-docs/scripts/markdown_to_html.py" ./docs/PR.md --doc-type pr --force```Verify bundled fixtures:```bashpython3 "$HOME/plugins/html-docs/scripts/verify_fixtures.py"```Fixture examples live at `references/fixtures/*.md`.

Frequently asked questions

HTML Docs

File contents

HTML Docs

Workflow

Output Rules

Useful Commands

Related skills

Frequently asked questions

How do I install the HTML Docs skill?

What does the HTML Docs skill do?

Is HTML Docs safe to use?

Which AI agents work with HTML Docs?

Is HTML Docs free to use?

Who published HTML Docs?