Agent-Skills.md

Agent Skills: Single HTML Page

>-

UncategorizedID: connorads/dotfiles/single-html-page

Repository

connorads/dotfiles
connorads
142

Install this agent skill to your local

pnpm dlx add-skill https://github.com/connorads/dotfiles/tree/HEAD/.config/skills/personal/single-html-page

Skill Files

Browse the full folder contents for single-html-page.

Download Skill

Loading file tree…

.config/skills/personal/single-html-page/SKILL.md

Skill Metadata

Name
single-html-page
Description
>-

Single HTML Page

Create one HTML file that can be shared without its original asset folder or live network dependencies.

Default Path

Use scripts/single_html_page.py (EXECUTE) unless the user asks to do the bundling manually:

python3 scripts/single_html_page.py input.html
python3 scripts/single_html_page.py https://example.com/page --output page-shareable.html

The script wraps monolith, removes leftover network hint and base links, and verifies that asset-bearing references are embedded as data URIs.

agents/openai.yaml is UI metadata only; do not read it for runtime guidance.

Tool Choice

Prefer monolith from PATH. It is the primary bundler because it embeds linked CSS, images, JavaScript, and fonts into one HTML document. If monolith is missing, check the local tool manager first (nix/home-manager or mise) instead of installing an ad hoc replacement.

For local HTML files, the script sets the base URL to the file's directory so relative assets resolve correctly. For URLs, the script lets monolith fetch the page and its assets directly.

Workflow

  1. Run the script and write *-shareable.html unless the user names an output.
  2. Read the script's verification summary. If it reports remaining asset refs, inspect and either fix them or tell the user what still depends on network or local files.
  3. For user-facing pages, render at least one screenshot. Use desktop and mobile screenshots when responsive layout matters.
  4. Preserve page content and behaviour. This skill packages the page; it does not restyle, rewrite, or redesign it.

Verification

Accept external links in normal anchors, but do not accept asset-bearing references such as img src, script src, stylesheet/icon link href, srcset, CSS url(...), or @import unless they are data: or fragment references.

If the page relies on JavaScript-rendered DOM that is not present in the source HTML, render or dump the browser DOM first, then run the bundler on that HTML with the original page URL as the base URL.