---
name: HTML Plan
slug: html-plan
category: Writing
description: HTML Plan creates a single self-contained HTML file from source material, preserving scope, order, commitments, and terminology while improving hierarchy, sequence, ownership, dependencies, and reviewability. Use it when a plan request is explicitly invoked or routed from the html skill.
github: "https://github.com/plannotator/effective-html/tree/main/skills/html-plan"
language: HTML
stars: 1666
forks: 130
install: "npx degit https://github.com/plannotator/effective-html/tree/main/skills/html-plan ~/.claude/skills/html-plan"
installs_to: ~/.claude/skills/html-plan
source_path: skills/html-plan/SKILL.md
collection_size: 6
category_size: 1012
collection_url: "https://dirskills.com/collections/plannotator/effective-html"
added: 2026-08-19T07:26:06.915Z
last_synced: 2026-08-19T07:26:06.915Z
canonical_url: "https://dirskills.com/skills/html-plan"
---

# HTML Plan

HTML Plan creates a single self-contained HTML file from source material, preserving scope, order, commitments, and terminology while improving hierarchy, sequence, ownership, dependencies, and reviewability. Use it when a plan request is explicitly invoked or routed from the html skill.

**Install:**

```bash
npx degit https://github.com/plannotator/effective-html/tree/main/skills/html-plan ~/.claude/skills/html-plan
```

## README

# HTML Plan

Turn source material into a plan people can inspect and act on. Preserve the user's scope, ordering, commitments, and terminology unless they ask for broader synthesis.

## Shape the document around the work

Read the conversation, project instructions, and supplied plan before designing. Match an existing design language when one is present. Otherwise derive a quiet, workmanlike direction from the audience and subject.

When [`design-artifact`](../design-artifact/SKILL.md) is available, read its
fundamentals to make that direction intentional. Keep this skill's traceability
and source-preservation rules authoritative; creative direction must not
inflate the plan into a dashboard or campaign page.

Decide what the plan actually needs:

- phases or sequence;
- status and decision points;
- owners and collaborators;
- dependencies and risks;
- acceptance checks;
- unresolved questions.

Do not add a timeline, progress percentage, status badge, or dashboard summary unless the source supports it. Improve grammar and structure without inflating an implementation plan into a strategy document.

## Preserve traceability

- Keep source commitments recognizable.
- Separate accepted decisions from assumptions and open questions.
- Show sequence and dependency only where they are real.
- Use tables for exact mappings, comparisons, or repeated fields.
- Use a flow or timeline only when it makes order materially easier to understand.
- Keep long prose readable instead of forcing every paragraph into a card.

## Build and verify

Deliver one responsive, accessible, self-contained HTML file. Use semantic headings, lists, tables, and landmarks. Keep essential CSS and JavaScript inline, avoid external services, and make any navigation or disclosure keyboard-operable.

Inspect the result at wide and narrow widths. Check that no commitment disappeared, that stages remain in the intended order, that ownership and dependencies are legible, and that long content does not overflow.

Return the absolute path and note any structural interpretation you introduced.