DocumentbchoorFree

writing-rich-docs

Cursor entrypoint for rich human-review docs (spec/design/ADR/retro/postmortem). Produces Markdown with embedded HTML blocks — Markdown for structure/prose, HTML blocks for high-fidelity content (decision cards, comparison matrices, grids, callouts, inline-SVG diagrams).

Repo bundle on Versuzbchoor/p2e-plugin27 indexed entries (SKILL.md and CLAUDE.md) from this repository — open the full bundle view.

Open bundle →

View on GitHub ↗</>github.com/bchoor/p2e-plugin Yours? Claim it ↗

§ 01 — Stats

Prior1090

Quality—

Score—

Tasks—

§ 02 — Install

Get writing-rich-docs.

Free SKILL.md scraped from GitHub. Clone the repo or copy the file directly into your Claude Code skills directory.

One-line install · Claude Code

$npx versuz@latest install bchoor-p2e-plugin-cursor-skills-writing-rich-docs

Or clone the repo

$git clone https://github.com/bchoor/p2e-plugin.git

Or copy the SKILL.md manually

$cp p2e-plugin/SKILL.MD ~/.claude/skills/bchoor-p2e-plugin-cursor-skills-writing-rich-docs/SKILL.md

More Versuz picks

★ Featured$1.99

vz-bench-debug

Document

★ Featured$0.99

vz-scrape-runner

Web

Got something better ?Submit your skill — it enters tomorrow's cycle. No fee.

Submit yours →

§ 05 — Challenge

Think you can beat it?

$npx versuz challenge bchoor-p2e-plugin-cursor-skills-writing-rich-docs↵

Show SKILL.md content (~456 tokens)

---
name: writing-rich-docs
description: Cursor entrypoint for rich human-review docs (spec/design/ADR/retro/postmortem). Produces Markdown with embedded HTML blocks — Markdown for structure/prose, HTML blocks for high-fidelity content (decision cards, comparison matrices, grids, callouts, inline-SVG diagrams).
paths:
  - "docs/feat-*/**"
  - "docs/adrs/**"
---

# writing-rich-docs

Thin Cursor wrapper. The canonical skill — the MD+HTML-block model, the bundled template, the component snippets, the promote-or-not menu — lives at `skills/writing-rich-docs/SKILL.md` (with `references/template.md`, `references/components.md`, `references/strategies.md`, and `references/template.html` for the pure-HTML path) and the workflow contract at `workflows/p2e-rich-docs.md`. Read those and apply them exactly.

Default output: a `.md` file with YAML front-matter, the `<style>` preamble from `references/template.md`, prose/structure in Markdown, and HTML blocks (each wrapped in `<div class="rich-doc" id="…">`) wherever a visual structure carries the content better. Diagrams are inline SVG only — never Mermaid. Inside HTML blocks: no JS, no `<details>`, no anchor-link nav, no sticky/fixed positioning, no in-doc TOC. doc-reviewer renders mixed Markdown + HTML and anchors comments to both.

## Cross-platform note

The `/p2e-html`, `/p2e-md`, and `/p2e-md-to-html` override commands are Claude-Code-specific (they override the audience auto-classifier in `~/.claude/CLAUDE.md`) and have no Cursor or Codex equivalent — that asymmetry is intentional. This `writing-rich-docs` skill is the cross-platform doc-rendering surface; the Codex mirror is `skills/writing-rich-docs/SKILL.md`.