Back to Skills

html-plan

Create a self-contained HTML plan that is pragmatic, simple, and visually organized. Use when the user wants a plan page in the effective HTML style, wants the writing kept close to what they gave you, or wants the grammar cleaned up without turning it into a whole bigger thing.

1,441stars111forksUpdated 7/30/2026

Security Assessment

Safe(95/100)
Security Score95/100

About html-plan

HTML Plan creates self-contained HTML plan pages in the pragmatic, visually organized style of the bundled effective-HTML example gallery. It solves the problem of turning rough plan text into a clean, single-file HTML page while keeping the writing close to what the user provided, cleaning up grammar without inflating the content into something larger than intended.

The skill instructs the agent to review a large gallery of standalone reference HTML examples under references/html-effectiveness (covering code review, design systems, slide decks, status and incident reports, flowcharts, explainers, and small interactive editors) and then produce a plan HTML file in a similar pragmatic, simple style. It mandates that every generated page include dark mode implemented with hand-rolled CSS variables on :root / html.dark, a small theme toggle button, localStorage persistence of the choice, and an apply-before-paint script in the head that defaults to prefers-color-scheme to avoid a flash. The reference material is static, dependency-free, self-contained HTML with no server-side components or build step, and its own security policy notes the main concerns are unsafe inline script behavior or misleading content.

It targets writers, planners, and developers who want a lightweight, shareable plan page rather than a heavyweight document. Typical use cases include drafting an implementation plan, cleaning up and formatting notes into an organized page, and producing a themed, single-file HTML deliverable that opens directly in a browser. Note the skill sets disable-model-invocation, so it is intended to be invoked explicitly.

FAQ

What does this skill generate?

A single, self-contained HTML plan page styled after the effective-HTML example gallery, keeping the writing close to the user's input while tidying grammar and organizing it visually.

Does the output include dark mode?

Yes, always. Every page includes hand-rolled CSS variables on :root / html.dark, a small theme toggle button, localStorage persistence, and an apply-before-paint script in the head that defaults to prefers-color-scheme.

Does it need any dependencies or a build step?

No. The reference examples and the generated plan are standalone HTML with no server-side components, no build pipeline, and no third-party runtime dependencies; you just open the file in a browser.

How is it invoked?

It sets disable-model-invocation: true, so it is meant to be triggered explicitly when the user asks for a plan page in the effective HTML style rather than auto-activated.

Will it rewrite or expand my content significantly?

No. The intent is to stay pragmatic and simple, keep the writing close to what you gave, and clean up grammar without turning it into a bigger thing.

All Files

27 files
agents/openai.yaml0.2 KB
View
references/html-effectiveness/03-code-review-pr.html25.7 KB
View
references/html-effectiveness/06-component-variants.html16.3 KB
View
references/html-effectiveness/09-slide-deck.html16.2 KB
View
references/html-effectiveness/12-incident-report.html15.2 KB
View
references/html-effectiveness/15-research-concept-explainer.html13.1 KB
View
references/html-effectiveness/18-editor-triage-board.html18.2 KB
View
references/html-effectiveness/CODE_OF_CONDUCT.md1.9 KB
View
references/html-effectiveness/README.md1.4 KB
View
references/html-effectiveness/01-exploration-code-approaches.html14.2 KB
View
references/html-effectiveness/04-code-understanding.html17.5 KB
View
references/html-effectiveness/07-prototype-animation.html12.2 KB
View
references/html-effectiveness/10-svg-illustrations.html18.0 KB
View
references/html-effectiveness/13-flowchart-diagram.html14.7 KB
View
references/html-effectiveness/16-implementation-plan.html28.0 KB
View
references/html-effectiveness/19-editor-feature-flags.html18.5 KB
View
references/html-effectiveness/index.html37.4 KB
View
references/html-effectiveness/SECURITY.md0.8 KB
View
references/html-effectiveness/02-exploration-visual-designs.html13.7 KB
View
references/html-effectiveness/05-design-system.html17.7 KB
View
references/html-effectiveness/08-prototype-interaction.html10.6 KB
View
references/html-effectiveness/11-status-report.html16.1 KB
View
references/html-effectiveness/14-research-feature-explainer.html11.7 KB
View
references/html-effectiveness/17-pr-writeup.html23.9 KB
View
references/html-effectiveness/20-editor-prompt-tuner.html20.7 KB
View
references/html-effectiveness/LICENSE11.1 KB
View
SKILL.md0.7 KB
View

Install html-plan

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill