Agent skill

HTML Plan

by plannotator in plannotator/effective-html

Direct-invocation specialist for clear, self-contained HTML plans that preserve source material while improving hierarchy, sequence, ownership, dependencies, and reviewability.

MITAuto-check passedFrontend & Design

Install HTML Plan

skills CLI
$ npx skills add plannotator/effective-html --skill html-plan -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install plannotator/effective-html html-plan --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/plannotator/effective-html.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/html-plan .claude/skills/html-plan && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
html-plan
GitHub stars
3.6k
Token cost
~614 tokens
SKILL.md length
285 words
Files
2
Skills in repo
4
Repo updated
First seen
Licence
MIT

At a glance

Direct-invocation specialist for clear, self-contained HTML plans that preserve source material while improving hierarchy, sequence, ownership, dependencies, and reviewability.

  • The user explicitly invokes html-plan
  • SKILL.md covers Shape the document around the…, Preserve traceability and Build and verify
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • The broad html skill routes a plan request here

What it does

HTML Plan is an agent skill from plannotator/effective-html. Direct-invocation specialist for clear, self-contained HTML plans that preserve source material while improving hierarchy, sequence, ownership, dependencies, and reviewability. Use when the user explicitly invokes html-plan or the broad html skill routes a plan request here. Do not activate independently from a general request.

Its SKILL.md is about 610 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Frontend & Design. The repository describes itself as: Agent skills for useful HTML artifacts, wireframes, interactive prototypes, plans, and diagrams. The licence is MIT.

When your agent uses it

  • The user explicitly invokes html-plan
  • The broad html skill routes a plan request here

Example prompts

  • “/html-plan”

What it can do on your machine

Read from SKILL.md and the folder at commit 2ac1dfe. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

HTML Plan loads about 614 tokens when it runs. Until then it costs about 85 tokens; SKILL.md has 285 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~85
When it runs · the whole SKILL.md, loaded when a task matches
~614

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from plannotator/effective-html at commit 2ac1dfe, republished under its MIT licence (© plannotator). 285 words, ~614 tokens.

Download SKILL.mdSave it as .claude/skills/html-plan/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
html-plan
description
Direct-invocation specialist for clear, self-contained HTML plans that preserve source material while improving hierarchy, sequence, ownership, dependencies, and reviewability. Use when the user explicitly invokes html-plan or the broad html skill routes a plan request here. Do not activate independently from a general request.

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 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.

© plannotator, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/html-plan of plannotator/effective-html.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 2ac1dfe

Compare with similar skills

HTML Plan next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

HTML Plan compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
HTML Plan this skillplannotator/effective-html3.6k—~614Automated safety check: PassMIT
Web Artifacts Builderanthropics/skills180k40 repos~769Automated safety check: PassApache-2.0
React Doctormakeplane/plane60k12 repos~657Automated safety check: PassAGPL-3.0
React Composition Patternsvercel-labs/openreview1.7k58 repos~721Automated safety check: PassMIT
Impeccablebestofjs/bestofjs3.1k27 repos~2.6kAutomated safety check: PassMIT
Figma Design System Builderwarpdotdev/warp65k2 repos~4.4kAutomated safety check: PassAGPL-3.0

Similar skills

  • Web Artifacts Builder

    anthropics/skills

    Official

    Builds multi-component claude.ai HTML artifacts as a small React, TypeScript and Tailwind project, then bundles it into one shareable HTML file.

    180k GitHub starsUsed in 40 repos~769 tokens
    Frontend & DesignAuto-check passed
  • React Doctor

    makeplane/plane

    Scans React code for lint, accessibility, bundle size and architecture issues, reports a health score and checks that changes do not lower it.

    60k GitHub starsUsed in 12 repos~657 tokens
    Frontend & DesignAuto-check passed
  • React Composition Patterns

    vercel-labs/openreview

    Official

    Rules for structuring React components with composition instead of boolean props, covering compound components, lifted state, variants and React 19 changes.

    1.7k GitHub starsUsed in 58 repos~721 tokens
    Frontend & DesignAuto-check passed
  • Impeccable

    bestofjs/bestofjs

    A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…

    3.1k GitHub starsUsed in 27 repos~2.6k tokens
    Frontend & DesignAuto-check passed
  • Builds or updates a design system in Figma from a codebase in ordered phases: discovery, variables and tokens, components, theming and documentation, with checkpoints.

    65k GitHub starsUsed in 2 repos~4.4k tokens
    Frontend & DesignAuto-check passed
  • Tailwindcss Development

    anonaddy/anonaddy

    Always invoke when the user's message includes 'tailwind' in any form.

    4.9k GitHub starsUsed in 10 repos~865 tokens
    Frontend & DesignAuto-check passed

More from plannotator/effective-html

  • HTML

    plannotator/effective-html

    Create or redesign self-contained single-file HTML artifacts with a visual direction shaped by the user's brief, project, and subject.

    3.6k GitHub stars~1.6k tokensUpdated 23 days ago
    Auto-check passed
  • HTML Diagram

    plannotator/effective-html

    Direct-invocation specialist for self-contained HTML diagrams whose layout, notation, and interaction clarify relationships, sequence, topology, state, hierarchy, or quantitative structure.

    3.6k GitHub stars~678 tokensUpdated 23 days ago
    Auto-check passed
  • HTML Prototype

    plannotator/effective-html

    Direct-invocation specialist for polished, responsive, self-contained HTML mockups and interactive prototypes grounded in the user's conversation, product context, and design language.

    3.6k GitHub stars~1.5k tokensUpdated 23 days ago
    Auto-check passed

Questions about HTML Plan

What does HTML Plan do?

Direct-invocation specialist for clear, self-contained HTML plans that preserve source material while improving hierarchy, sequence, ownership, dependencies, and reviewability. HTML Plan is an agent skill from plannotator/effective-html. Direct-invocation specialist for clear, self-contained HTML plans that preserve source material while improving hierarchy, sequence, ownership, dependencies, and reviewability.

When should I use HTML Plan?

HTML Plan fits situations like: the user explicitly invokes html-plan; the broad html skill routes a plan request here.

How do I install HTML Plan in Claude Code?

Run `npx skills add plannotator/effective-html --skill html-plan -a claude-code`. Or copy the skill folder (skills/html-plan in plannotator/effective-html) into .claude/skills/html-plan in your project. Claude Code loads it when a task matches its description.

How do I install HTML Plan in Codex?

Run `npx skills add plannotator/effective-html --skill html-plan -a codex`. Or copy the skill folder (skills/html-plan in plannotator/effective-html) into .agents/skills/html-plan in your project. Codex loads it when a task matches its description.

Can I use HTML Plan in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add plannotator/effective-html --skill html-plan -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/html-plan, .gemini/skills/html-plan, .github/skills/html-plan and .opencode/skills/html-plan in your project.

What does HTML Plan need to run?

SKILL.md names no scripts, command-line tools or credentials: HTML Plan is instructions for the agent only.

Does HTML Plan access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is HTML Plan safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does HTML Plan use?

HTML Plan is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does HTML Plan use?

About 614 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to HTML Plan?

Skills that share tags, products or a category with HTML Plan: Web Artifacts Builder (anthropics/skills, 180k stars), React Doctor (makeplane/plane, 60k stars), React Composition Patterns (vercel-labs/openreview, 1.7k stars) and Impeccable (bestofjs/bestofjs, 3.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains HTML Plan?

plannotator (a GitHub organization) maintains it in plannotator/effective-html, which has 3,555 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on September 14, 2026.

Source: plannotator/effective-html on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.