explaingit

plannotator/effective-html

Analysis updated 2026-05-18

764HTMLAudience · vibe coder

TLDR

A skill pack for AI coding agents that generates clean, self-contained HTML diagrams and plan pages.

Mindmap

mindmap
  root((effective-html))
    What it does
      Agent skills for HTML output
      Clean visual style
      Self-contained files
    Skills
      html
      html-diagram
      html-plan
    Tech stack
      HTML
      SVG
      Node CLI installer
    Integrations
      Claude Code plugin
      Codex plugin
      Plannotator companion tool
    Audience
      Vibe coders
      Agent builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Add a skill to Claude Code or Codex that generates polished HTML architecture diagrams.

USE CASE 2

Turn a written plan or system description into a visually clean single-file HTML page.

USE CASE 3

Give a coding agent reference examples so its HTML output looks more professional.

USE CASE 4

Pair with the Plannotator tool to render and annotate the generated HTML.

What is it built with?

HTMLSVGNode.js

How does it compare?

plannotator/effective-htmltwbs/examplesanthropics/launch-your-agent
Stars764681678
LanguageHTMLHTMLHTML
Last pushed2026-07-02
MaintenanceActive
Setup difficultyeasymoderate
Complexity1/53/5
Audiencevibe coderdeveloperpm founder

Figures from each repo's GitHub metadata at analysis time.

In plain English

This repository is a collection of skills for AI coding assistants that help them produce clean, self-contained HTML files. HTML is the language web pages are written in, and a self-contained file means everything needed to view it lives in that one file. The focus is on output that looks good visually, so the project is aimed at people who want diagrams, plans, and other documents rather than full websites. There are three skills in the set. The first, called html, makes a single HTML file for whatever you describe, following a particular clean style the author refers to as effective HTML. The second, html-diagram, builds full-screen diagrams that show how a system or technology stack fits together, using high-quality vector graphics and very little text. The third, html-plan, creates HTML pages laid out as plans, again in the same visual style. Installing the skills is done through a command line tool. You can list what is available first, then add all of them or just one specific skill. The repository also works as a plugin marketplace for two coding assistants, Claude Code and Codex, with short commands shown for registering the marketplace and installing the plugin in each. The README explains how the project is organized. Each skill lives in its own folder with an instruction file, and each one bundles a local copy of a set of example HTML documents so the references stay close to the skill that uses them. The author credits those examples, called html-effectiveness, to another person named Thariq Shihipar. The README is short and points to outside material, including a demo video and an optional companion tool called Plannotator for rendering and annotating the HTML you create. The author also mentions that one of the sample diagrams was generated by a model named Fable 5, and that more such examples will be added so smaller models can learn from them. This is a focused helper for generating visual documents, not a large application on its own.

Copy-paste prompts

Prompt 1
Install the html-diagram skill from plannotator/effective-html and use it to diagram my project's architecture.
Prompt 2
Use the html-plan skill to turn this project outline into a clean HTML plan page.
Prompt 3
Explain what makes an HTML file self-contained and why that matters for sharing diagrams.
Prompt 4
Show me how to register plannotator/effective-html as a Claude Code plugin marketplace.

Frequently asked questions

What is effective-html?

A skill pack for AI coding agents that generates clean, self-contained HTML diagrams and plan pages.

What language is effective-html written in?

Mainly HTML. The stack also includes HTML, SVG, Node.js.

Who is effective-html for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.