Skip to content

borghei/Claude-Skills / markdown-html/md-document

md-document

Verified

Convert authored markdown into a polished self-contained HTML document with a table of contents, numbered figures and tables, cross-references, footnotes, and print-ready CSS. Use when publishing a report, whitepaper, or memo.

assets/document_outline_template.md

View on GitHub
---
title: <Document title>
author: <Team or person>
date: <YYYY-MM-DD>
status: draft
audience: <exec / working team / external>
---

# <Document title>

<Two to four sentences: what question this document answers, what it covers, and
what it concludes. A reader who stops here should still know the recommendation.>

[TOC]

## Context {#sec:context}

<What is true today and why it matters now. Numbers, not adjectives. This section
earns the reader's attention — if the situation is not clearly a problem, the
rest of the document has no purpose.>

![<Describe what the figure shows, 15-125 characters>](figures/<name>.png){#fig:context}

## Analysis {#sec:analysis}

<The evidence. One subsection per line of argument.>

### <First line of argument>

<Prose. Reference evidence by number — [@fig:context], [@tbl:options] — never
"the chart below".>

| Option | <Dimension> | <Dimension> | <Dimension> |
|--------|-------------|-------------|-------------|
| A      |             |             |             |
| B      |             |             |             |
| C      |             |             |             |

Table: <What the table shows and how to read it> {#tbl:options}

### <Second line of argument>

<Prose. Put the caveat that would break the sentence in a footnote.[^caveat]>

## Recommendation {#sec:recommendation}

**<State the recommendation in bold, as a directive, in one sentence.>**

<Why this option and not the others. Reference [@tbl:options] explicitly. Name
the option you rejected and why — a recommendation that does not say what it
rejected reads as though only one option was considered.>

### What this costs

<The honest downside. Every recommendation has one. Omitting it does not make it
disappear; it makes the reader distrust the rest.>

### What happens next

1. <Action> — <owner> — <date>
2. <Action> — <owner> — <date>

## Open questions {#sec:open}

- <Question that would change the recommendation if answered differently>
- <Question that does not block the decision but needs an owner>

---

[^caveat]: <The qualification, the exception, or the assumption that a careful
    reader would otherwise challenge.>

<!--
Before publishing:
  1. crossref_auditor.py  — labels, references, alt text, heading hierarchy
  2. md_to_html.py        — convert; the gate fails on unresolved references
  3. print_profile.py     — if this will be printed or exported to PDF
  4. Proof every page of the PDF, not just the first three
-->
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall