К основному содержанию
скилл CX Codex

html-doc — скилл для Claude Code: что делает и как установить

Скилл html-doc превращает готовый Markdown PRD или технический дизайн в статическую HTML-страницу для чтения в браузере. Он также проверяет результат.

MIT 288 установок ★ 438 обновлён 2026-11-10

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add owainlewis/blueprint --skill html-doc -a claude-code
Открыть на GitHub

Что делает html-doc

html-doc берёт готовый Markdown-файл или точный Markdown из запроса и создаёт одну HTML-страницу для документа типа prd или design. Исходный текст остаётся каноническим: скилл меняет подачу, но не пишет требования, не редактирует исходник и не публикует результат. Для генерации используется scripts/html_doc.py, а итог проходит через отдельные этапы создания, проверки и финализации.

Страница получает семантическую HTML-разметку, встроенные стили без внешних ресурсов, адаптацию для экрана и печати, оглавление, доступные элементы и Mermaid-диаграммы в виде встроенного SVG. Перед первой отрисовкой Mermaid нужен npm ci --prefix <skill-directory>. Для работы также требуются Python 3.11 или новее, Pandoc 3 или новее, Node.js 22.12 или новее и npm. Без этих зависимостей генерация не запустится.

При проверке скилл открывает кандидат в браузере и смотрит размеры 1440, 768 и 390 CSS-пикселей, печать A4 и US Letter, клавиатурную навигацию, переполнение, ошибки консоли и работу без сети. Финализация атомарно заменяет предыдущий файл только после успешных проверок.

Какие задачи решает

  • превратить Markdown PRD в читаемую HTML-страницу
  • оформить технический дизайн для браузера и печати
  • проверить оглавление, ссылки и клавиатурную навигацию
  • показать Mermaid-диаграммы внутри статического документа
  • сохранить исходный Markdown без изменения смысла

Примеры запросов агенту

  • Преобразуй REQUIREMENTS.md в статическую HTML-страницу и проверь её в браузере.
  • Оформи ARCHITECTURE.md как документ типа design, затем проверь мобильный вид и печать.
  • Возьми spec.md, создай HTML-кандидат, проверь диаграммы и финализируй только после успешных проверок.

Как установить html-doc

1Через Skills CLI (Vercel)

npx skills add owainlewis/blueprint --skill html-doc -a claude-code

2Вручную: положить файлы

~/.claude/skills/html-doc/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/html-doc/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о html-doc

Как установить html-doc в Claude Code?

Выполните npx skills add owainlewis/blueprint --skill html-doc -a claude-code, затем проверьте файл ~/.claude/skills/html-doc/SKILL.md.

Что делает html-doc?

Скилл превращает готовый Markdown PRD или технический дизайн в статическую HTML-страницу. Он проверяет отображение, доступность, диаграммы и печать перед финализацией.

Какие документы поддерживает html-doc и что нужно для работы?

Поддерживаются только документы типов prd и design. Нужны Python 3.11 или новее, Pandoc 3 или новее, Node.js 22.12 или новее и npm; перед первой отрисовкой Mermaid запускают npm ci --prefix <skill-directory>.

Исходный текст

SKILL.md · MIT
---
name: html-doc
description: Generates a polished, static HTML reading view from an existing Markdown PRD or technical design. Use when a user asks to render, present, visualize, or make a PRD or design document easier for humans to read in a browser.
user-invocable: true
argument-hint: "<Markdown PRD or design file>"
disable-model-invocation: true
---

# HTML document

Turn one complete Markdown PRD or technical design into one verified static HTML page. Keep Markdown canonical. Change presentation, not meaning.

## Boundaries

- Accept an existing Markdown file or exact inline Markdown.
- Support only `prd` and `design` document kinds.
- For `REQUIREMENTS.md`, pass `--kind prd`. For `ARCHITECTURE.md` or `spec.md`, pass `--kind design`.
- Classify `prd.md` as `prd` and `design.md` as `design`. For other names, use the request or ask if the kind is unclear.
- Do not write requirements, settle design choices, summarize missing content, or edit the source.
- If the source is only a rough brief, use the appropriate authoring skill first.
- Do not hand-edit generated HTML. Change the template or renderer, then regenerate.
- Do not publish or host the result unless the user separately asks.

## Requirements

Generation requires Python 3.11 or newer, Pandoc 3 or newer, Node.js 22.12 or newer, and npm. The skill directory contains a locked Mermaid dependency tree.

Before the first Mermaid render, run:

```bash
npm ci --prefix <skill-directory>
```

Use `scripts/html_doc.py` from this skill directory for all generation and lifecycle operations.

## Workflow

### 1. Read and classify the source

Read the complete source. Confirm it is no larger than 2 MiB. Determine the document kind from the request or the basename mappings above.

Treat content problems separately from presentation problems. If the Markdown contradicts itself, omits a required decision, or contains an invalid diagram, report that source problem. Do not silently repair its meaning.

### 2. Create a candidate

For a file source:

```bash
python3 <skill-directory>/scripts/html_doc.py render <source.md> --kind <prd-or-design> --out <output.html>
```

`--kind` may be omitted only for exact `prd.md` and `design.md` basenames. `--out` may be omitted to create a sibling HTML file.

For exact inline Markdown, pipe it through standard input and provide both kind and output:

```bash
python3 <skill-directory>/scripts/html_doc.py render --inline --kind <prd-or-design> --out <output.html>
```

The command returns JSON containing `candidate`, `output`, and `token`. It does not replace the final output. Keep those exact values for verification and finalization.

If an output lock already exists, do not delete it automatically. It may represent another pending render. Report its path. Use `discard --force-stale` only when the state is known to be abandoned.

### 3. Verify the candidate in a real browser

Open the candidate as a local file. Do not treat source inspection as browser proof.

Check all of these:

- desktop at 1440 CSS pixels;
- tablet at 768 CSS pixels;
- mobile at 390 CSS pixels;
- A4 and US Letter print preview;
- table-of-contents links and section targets;
- keyboard order from skip link through navigation and document links;
- visible focus indicators;
- one `main` landmark and a sensible heading outline;
- unique DOM IDs;
- horizontal overflow, clipped text, code, tables, and diagrams;
- useful diagram alternatives and accessible disclosure controls;
- console errors and failed resource requests;
- operation with browser network access disabled.

Compare the canonical content inside `main` with the Markdown abstract syntax tree. Navigation, source metadata, and derived accessibility text are not canonical content. Each top-level source block must map to one ordered `data-source-block` node with its SHA-256 identity and nested content intact. A Mermaid block maps to one figure whose exact source appears once in its disclosure.

If a presentation defect comes from the shared renderer or styles, fix that source and regenerate. If it is a content defect, leave the source and candidate unchanged and report it.

### 4. Finalize or discard

Only after every check passes, atomically install the candidate:

```bash
python3 <skill-directory>/scripts/html_doc.py finalize --out <output.html> --token <token>
```

If any check fails, remove only this pending candidate:

```bash
python3 <skill-directory>/scripts/html_doc.py discard --out <output.html> --token <token>
```

Finalization performs one same-directory atomic replacement. It never deletes the previous output first. A failed render, check, or replacement must leave the previous verified output byte-for-byte unchanged.

## Output standard

The final page must:

- preserve source wording and order;
- use canonical `prd` or `design` machine metadata;
- record the source path and SHA-256 hash;
- use semantic HTML, inline CSS, and no runtime JavaScript;
- contain no external runtime assets;
- use a restrained blue-grey visual system;
- remain readable without color, a mouse, a wide screen, or network access;
- include responsive and print styles;
- embed validated Mermaid SVG as a base64 image and retain the exact source in a disclosure.

## Return

Stop when the verified candidate is finalized. Report the output path, source
hash, and browser checks performed.

© owainlewis · MIT · owainlewis/blueprint

Похожие скиллы

Все скиллы по теме «Тексты и документация» →
baoyu-markdown-to-html JimLiu Скилл baoyu-markdown-to-html для Claude Code переводит Markdown в HTML с инлайн-CSS и темами под WeChat для публикации в мессенджере или на площадке со своим оформлением. CX Codex +1 32 900установок design-doc-mermaid SpillwaveSolutions Скилл design-doc-mermaid генерирует диаграммы Mermaid и техническую документацию по коду или описанию задачи. Подходит для оформления GitHub wiki, системных архитектур и схем баз данных. CX Codex +1 101 800установок article-to-html agentara Скилл article-to-html для Claude Code превращает Markdown или документ из контекста в один HTML-файл с оформлением статьи. Создаёт статичную веб-версию без слайдов и PDF. CX Codex +1 220установок html-visualization sevos Скилл html-visualization для Claude Code генерирует автономные интерактивные HTML-страницы со схемами Mermaid и подсветкой кода из репозитория. Создаёт наглядные гайды и слайды. CX Codex +1 2установок markdown-html-skills Alireza Rezvani Плагин markdown-html-skills превращает длинные Markdown-файлы в одностраничный интерактивный HTML. Подходит для документов, ревью кода и слайдов. ★ 30 251звёзд репо doc-to-markdown daymade Скилл doc-to-markdown для Claude Code и Codex конвертирует DOCX, PDF, PPTX и сохранённый HTML в Markdown с автоматической зачисткой разметки. Включается при запросах на парсинг документов. CX Codex +1 945установок

Из того же набора9

plan Скилл plan делит спецификацию на законченные вертикальные срезы, каждый из которых агент сдаёт в одном pull request. Срабатывает при планировании крупной задачи перед написанием кода. CX Codex +1 788установок review Скилл review для Claude Code и Codex запускает изолированное ревью изменений без права записи. Проверяет совпадение со спецификацией, безопасность и поведение кода на некорректных данных. CX Codex +1 787установок task-to-pr Скилл task-to-pr ведёт задачу от тикета до открытого pull request: ветка, тесты, Conventional Commit, проверка CI и независимое ревью. Мержит только по явной команде. CX Codex +1 452установок spec Скилл spec для Claude Code и Codex формирует спецификацию отдельной фичи перед написанием кода. Он описывает пользовательские сценарии и технический дизайн в виде готового тикета. CX Codex +1 440установок improve Скилл improve для Claude Code упрощает существующий код, сохраняя его поведение. Агент ищет дубли, мёртвый код, слабые имена и лишние абстракции. CX Codex +1 372установок architecture-review Скилл architecture-review для Claude Code и Codex анализирует RFC, ADR или технические спецификации до написания кода. Проверяет архитектурные решения, риски безопасности и сценарии сбоев. CX Codex +1 347установок architecture Создаёт или обновляет файл ARCHITECTURE.md в корне проекта по шаблону. Сверяет требования с кодовой базой и фиксирует системные границы. CX Codex +1 331установок codex-issue-coordinator Скилл codex-issue-coordinator запускает отдельных AI-воркеров на каждую задачу из списка или вехи GitHub, следит за их PR и тестами, и сам мержит, когда всё готово. Подходит, когда нужно обработать пачку задач в одном потоке Codex. CX Codex +1 241установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой