All skills
plannotator avatar

/html

@e1e71db
by plannotatorplannotator/effective-html3.5k stars
238

Create or redesign self-contained single-file HTML artifacts with a visual direction shaped by the user's brief, project, and subject. Use when HTML is the deliverable for a report, explainer, landing page, presentation, tool, mixed artifact, or broad request. This is the collection's only implicit router. Route clear wireframe, prototype, mockup, plan, or diagram requests to the matching direct-invocation specialist when available. Do not use for ordinary application implementation when a standalone HTML file is not the deliverable.

Recorded with Claude Code, Opus 5.5

PromptMake a 7-slide pitch deck for Brothwheel, a neighborhood soup co-op that sells soup in returnable jars, where arrow keys or clicks advance the slides. Save it as deck.html, one file with all CSS and JavaScript inline.

Desktop screenshot of the page the Agent built for: Make a 7-slide pitch deck for Brothwheel, a neighborhood soup co-op that sells soup in returnable jars, where arrow keys
Use this Skill: https://skilld.dev/gh/plannotator/effective-html/html

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencescreative-direction.md

≈838 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Creative direction

Read this when the user or project has not already supplied a complete visual direction.

Operate like a small design studio with range, not a template engine with a favorite costume. Every artifact should feel designed for this commission. A planning memo, systems map, product demo, and launch deck can all show equal care without sharing a palette, typeface, silhouette, or amount of drama.

Find the direction inside the brief

Start with the subject's own world: its materials, tools, environments, notation, history, audience, and language. Pull one organizing idea from there. It might shape the grid, the behavior of a diagram, the rhythm of the type, the way information reveals itself, or the role of imagery.

Choose a register that fits:

  • Workmanlike: quiet hierarchy, exact spacing, restrained color, direct language. Right for plans, internal briefs, operational reports, and many tools.
  • Editorial: stronger composition, distinctive type, art-directed pacing, and one memorable visual move. Right for explainers, launches, research stories, and presentations that need to travel.
  • Expressive: a more immersive visual or interactive idea whose execution is itself part of the message. Use rarely, when the subject truly benefits.

Do not confuse restraint with neglect or expression with a theatrical hero. Finish the chosen register properly.

Make a short design plan

Before writing CSS, decide:

  • The visual premise in one sentence.
  • The hierarchy and organizing layout.
  • The color roles and why they belong to the subject.
  • The type roles and the voice each contributes.
  • The density, edge treatment, and image or diagram language.
  • The one place, if any, where motion or interaction carries meaning.

The number of colors, typefaces, columns, and components should follow the idea. Do not satisfy a quota.

Avoid the template reflex

Common components are not a visual direction. Cards, pills, rounded rectangles, gradients, tiny uppercase labels, large numerals, and side rails may be useful, but each must express real structure. Do not use them merely because they make an unfinished page look designed.

Vary more than color. A new palette on the same centered hero and card grid is still the same design. Reconsider composition, scale, density, typography, shape language, navigation, and interaction.

Use one decisive move rather than many unrelated flourishes. Let the rest of the page support it.

Typography should establish voice and hierarchy. One well-used family can outperform an arbitrary pairing; several roles are useful only when they remain coherent. Use system fonts when they suit the brief. Embed custom fonts only when their value justifies the file weight and their license permits it.

Color should be selected rather than inherited from habit. Neutrals are part of the palette. Status colors must remain semantically distinct from the decorative accent.

Respect prior art

When the user names a style or supplies a reference, follow it faithfully, even if it resembles a convention you would not choose yourself. When a project has tokens and components, use them before inventing replacements.

Bundled guidance is for technique, not imitation. Never copy a previous artifact's palette, typography, or composition simply because it worked once.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts2mo3 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    The skill is a design assistant for generating standalone HTML artifacts. While it adheres to safety best practices by discouraging unauthorized network connections, it remains susceptible to indirect prompt injection. This occurs because the skill is instructed to ingest project-level documentation (such as AGENTS.md or design-system files) to inform its design choices without using boundary markers or sanitization to differentiate between design data and potentially malicious embedded instructions.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: LOW · No issues

Signed by skilld at e1e71db. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 weeks ago.

Activeupdated 2 months ago

README badge

README badge for plannotator/effective-html/html