Skip to content
Back to search

effective-html

MarketplaceWorks with Claude CodeGitHub

Creative direction and focused skills for self-contained HTML artifacts, wireframes, interactive prototypes, plans, and diagrams.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/plannotator-effective-html/badge.svg)](/listings/plannotator-effective-html)

HTML

<a href="/listings/plannotator-effective-html"><img src="/api/listings/plannotator-effective-html/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Install the collection when you want these references available to your agent as reusable workflows:

npx skills add plannotator/effective-html

List or install individual skills:

npx skills add plannotator/effective-html --list
npx skills add plannotator/effective-html --skill design-artifact
npx skills add plannotator/effective-html --skill html-wireframe
npx skills add plannotator/effective-html --skill html-prototype

Claude Code plugin

/plugin marketplace add plannotator/effective-html
/plugin install plannotator-effective-html@effective-html

Codex plugin

codex plugin marketplace add plannotator/effective-html
codex plugin add plannotator-effective-html@effective-html

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 22 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "effective-html",
  3. "owner": {
  4. "name": "plannotator"
  5. },
  6. "description": "Creative direction and focused skills for self-contained HTML artifacts, wireframes, interactive prototypes, plans, and diagrams.",
  7. "plugins": [
  8. {
  9. "name": "plannotator-effective-html",
  10. "source": {
  11. "source": "url",
  12. "url": "https://github.com/plannotator/effective-html.git"
  13. },
  14. "description": "Give standalone HTML artifacts a subject-specific visual direction, then create wireframes, styled mockups, interactive prototypes, plans, diagrams, and general artifacts.",
  15. "homepage": "https://github.com/plannotator/effective-html",
  16. "repository": "https://github.com/plannotator/effective-html",
  17. "license": "MIT",
  18. "keywords": ["html", "design", "creative-direction", "wireframe", "prototype", "prototyping", "diagram", "plan", "html-artifacts", "agent-skills", "claude-code", "codex"],
  19. "category": "productivity"
  20. }
  21. ]
  22. }
README.md · README · 108 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src="./assets/effective-html-banner.png" width="1280" alt="Effective HTML by Plannotator — HTML wireframes, mockups, prototypes, charts, and diagrams">
  3. </p>
  4. # Effective HTML
  5. [简体中文](README.zh.md)
  6. Focused agent skills for creating useful, self-contained HTML artifacts, from low-fidelity wireframes to working interactive prototypes.
  7. ## Fat artifacts + fat context
  8. Modern models can do a lot. Give them plenty of useful references and use
  9. artifacts to show what you mean. HTML can visualize almost anything, often more
  10. clearly than a wall of text. Your prompt can simply point to the artifacts,
  11. repositories, and folders that carry the context.
  12. > [!NOTE]
  13. > You can use this repo without installing anything. Treat it as a reference
  14. > first and an installable skill collection second. See the
  15. > [Effective HTML guide](https://www.effectivehtml.com/).
  16. https://github.com/user-attachments/assets/24306977-7f30-44c9-9bff-55f901d557b0
  17. <p align="center">
  18. <a href="https://github.com/backnotprop/plannotator">
  19. <img src="./star-plannotator.svg" width="340" alt="Star Plannotator on GitHub">
  20. </a>
  21. </p>
  22. <p align="center">
  23. Render and annotate local HTML with <a href="https://github.com/backnotprop/plannotator">Plannotator</a>.
  24. </p>
  25. ## Skill references
  26. The repo includes eight optional skills for pragmatic visual artifacts.
  27. | Skill | Use it for |
  28. | --- | --- |
  29. | [`html`](skills/html/SKILL.md) | Broad HTML requests, mixed artifacts, reports, explainers, presentations, landing pages, tools, and routing to a specialist |
  30. | [`big-pics-little-words`](skills/big-pics-little-words/SKILL.md) | Explain the current subject in HTML with large visuals and minimal text while preserving key details; copied from [bro](https://github.com/backnotprop/bro/blob/main/skills/big-pics-little-words/SKILL.md) |
  31. | [`one-pager`](skills/one-pager/SKILL.md) | Make a one-pager: one HTML page that shares an idea with teammates early, or recaps work for them, with big pictures and little words; copied from [bro](https://github.com/backnotprop/bro/blob/main/skills/one-pager/SKILL.md) |
  32. | [`design-artifact`](skills/design-artifact/SKILL.md) | Subject-specific creative direction for any HTML artifact without imposing a reusable house style |
  33. | [`html-wireframe`](skills/html-wireframe/SKILL.md) | Low-fidelity layout directions that test content, hierarchy, navigation, flows, and responsive structure |
  34. | [`html-prototype`](skills/html-prototype/SKILL.md) | Working prototypes with realistic states, interaction, keyboard support, and responsive behavior |
  35. | [`html-plan`](skills/html-plan/SKILL.md) | Plans, roadmaps, rollouts, and implementation sequences that preserve source commitments |
  36. | [`html-diagram`](skills/html-diagram/SKILL.md) | Architecture, sequence, process, state, hierarchy, timeline, and system diagrams |
  37. Practical guide: [HTML Wireframes and Prototypes for Coding Agents](https://docs.plannotator.ai/learn/code-context/html-wireframes-and-prototypes-for-coding-agents).
  38. ## Install
  39. Install the collection when you want these references available to your agent as
  40. reusable workflows:
  41. ```bash
  42. npx skills add plannotator/effective-html
  43. ```
  44. List or install individual skills:
  45. ```bash
  46. npx skills add plannotator/effective-html --list
  47. npx skills add plannotator/effective-html --skill big-pics-little-words
  48. npx skills add plannotator/effective-html --skill one-pager
  49. npx skills add plannotator/effective-html --skill design-artifact
  50. npx skills add plannotator/effective-html --skill html-wireframe
  51. npx skills add plannotator/effective-html --skill html-prototype
  52. ```
  53. ### Claude Code plugin
  54. ```text
  55. /plugin marketplace add plannotator/effective-html
  56. /plugin install plannotator-effective-html@effective-html
  57. ```
  58. ### Codex plugin
  59. ```bash
  60. codex plugin marketplace add plannotator/effective-html
  61. codex plugin add plannotator-effective-html@effective-html
  62. ```
  63. ## How the skills work
  64. The skills separate creative freedom from reliability:
  65. - Visual direction comes from the conversation, project, audience, and subject.
  66. - `design-artifact` provides a reusable design process without prescribing a reusable look.
  67. - Wireframes stay intentionally unfinished so reviewers focus on structure.
  68. - Prototypes implement one credible flow and its relevant states.
  69. - Plans preserve source commitments.
  70. - Diagrams choose a visual model and rendering method that fit the relationship being explained.
  71. - Every artifact is responsive, accessible, self-contained, and verified in a browser.
  72. Detailed guidance lives only where it is needed. The broad `html` skill routes the work, `design-artifact` supplies optional creative direction, and specialist skills own fidelity and behavior. Each skill remains independently usable.
  73. This project was inspired by Thariq Shihipar's [The unreasonable effectiveness of HTML](https://thariqs.github.io/html-effectiveness).
  74. <p align="center">
  75. <a href="https://github.com/plannotator/tot">
  76. <img src="./use-tot.svg" width="300" alt="Share HTML with tot">
  77. </a>
  78. </p>
  79. <p align="center">
  80. Create a shareable link for an HTML file with <a href="https://github.com/plannotator/tot">tot</a>.
  81. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.