# HTML

> The html skill owns creating and revising durable, standalone HTML artifacts: a complete self-contained index.html saved in a requested or generated artifact directory, with inline dependencies, accessible structure, loopback serving, and exact-file verification. It triggers when a user asks to create, build, turn content or data into, save, revise, or update a “durable HTML artifact,” “one-file dashboard,” “single-page local artifact,” or named HTML artifact, or explicitly says “use /html” or “activate the HTML skill.” It does not trigger for integrating HTML into React or Next.js routing, reviewing or explaining HTML or accessibility, browser-based QA of an existing page, converting Figma designs into reusable components, or merely serving an existing dist directory.

- Skill: `eliasstravik/html` (Agent Skill)
- Install (CLI): `npx skillmds@latest add eliasstravik/html`
- Raw SKILL.md: https://api.skillmd.com/api/skills/eliasstravik/html/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Design & Media
- Author: eliasstravik (https://skillmd.com/u/eliasstravik)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/eliasstravik/html

---


# HTML

## Recipe

1. Resolve `ARTIFACT_DIR` inside the provided HTML state root, or expanded `~/.html` otherwise: revise a named artifact in place, or create a three-random-word lowercase slug for new work.
2. Write only `ARTIFACT_DIR/index.html` as a complete self-contained, source-faithful, responsive interface with semantic structure and accessible controls unless the user names another entry file.
3. Start a long-lived static server for `ARTIFACT_DIR` on `127.0.0.1` using a free non-common port.
4. Verify the exact `http://127.0.0.1:<PORT>/index.html` with files inside the task run, retrying from step 3 on another port if binding or fetching fails, and keep the verified server alive through handoff.
5. Reply with exactly `HTML file: <absolute entry-file path>` then `HTML: [Open locally](<verified /index.html URL>)`; if serving cannot be verified, omit the link and give the path plus one concise reason.

## Details

- Run `python3 -m http.server "$PORT" --bind 127.0.0.1 --directory "$ARTIFACT_DIR"` as the foreground command of a long-running tool session; do not background or detach it from a shell that will exit.