easy-html-deploy

Deploy a single self-contained HTML page to htmlcode.fun for instant sharing with optional stable short codes for easy in-place updates.

Security Scan

The skill's files, instructions, and network calls are consistent with its stated purpose (publishing single-file HTML to htmlcode.fun) and it does not request unrelated credentials or privileged access.

Purpose & Capability

Name/description, SKILL.md, and the bundled Python script all implement the same functionality: POST/PATCH/GET against htmlcode.fun to deploy, update, and fetch single-file HTML. No unrelated binaries, env vars, or config paths are requested.

Instruction Scope

Runtime instructions are narrowly scoped to producing a single HTML document, inlining assets, and sending JSON payloads to the service API. The SKILL.md and script only read the specified local HTML file(s) and perform network calls to https://www.htmlcode.fun; they do not read other system files, environment variables, or external endpoints.

Install Mechanism

No install spec — instruction-only plus a small Python script that uses the standard library (urllib). Nothing is downloaded or written to disk aside from user-specified outputs (get --output).

Credentials

The skill declares no required environment variables or credentials. The operations shown do not require secrets; that matches the anonymous or code-based short-link workflow described.

Persistence & Privilege

always is false; the skill does not request permanent/privileged presence or modify other skills or system settings. It may be invoked autonomously (platform default), which is appropriate for this tool-like skill.

Assessment

This skill will send whatever HTML you provide to https://www.htmlcode.fun and return the service response. Only deploy content you are comfortable hosting publicly (do not include secrets, credentials, or private data in the HTML). The payload limit is small (~1 MB); large images or embedded secrets can fail or leak data. If you need private or custom-domain hosting, use a different provider. Otherwise the included Python script is straightforward and uses only the Python standard library.

Overview

Use htmlcode.fun when the output can be delivered as one standalone HTML document and speed matters more than full project-hosting features. This skill is designed for agents that need the shortest path from HTML content to a live shareable URL.

Live example and walkthrough:

• https://www.htmlcode.fun/s/htmlcode-fun-guide

Bundled script:

• scripts/htmlcode_deploy.py for deploy, update, and fetch operations

Decision rule

Use this skill when all of the following are true:

• The deliverable is a single HTML page.
• The page can be self-contained or nearly self-contained.
• Fast sharing matters more than custom domains, CI/CD, or multi-file assets.

Do not use this skill when any of the following are true:

• The project is a React, Vue, Next, or multi-file frontend app.
• The site needs build steps, environment variables, or asset pipelines.
• The user specifically needs their own domain bound to the host.
• The page is likely to exceed the service limit of about 1 MB HTML payload.

Core workflow

1. Produce one complete HTML document.
2. Inline CSS and JS when practical.
3. Add quality metadata before deploy:
   • <title>
   • <meta name="description">
   • <meta name="viewport" content="width=device-width, initial-scale=1.0">
   • Open Graph tags when the page will be shared
4. Decide whether the page needs a stable short code.
   • For one-off pages, deploy without custom code.
   • For pages that will be updated in place, set enableCustomCode=true and choose customCode on first deploy.
5. Deploy with JSON to POST https://www.htmlcode.fun/api/deploy.
6. Save the returned code, url, and qrCode.
7. For later edits, update with PATCH https://www.htmlcode.fun/api/deploy/content using the same code.
8. If the API returns 429, wait for retryAfterSeconds before retrying.

Fastest path

Prefer the bundled script when working from local files.

Deploy a new page:

python scripts/htmlcode_deploy.py deploy page.html --title "launch-page" --code launch-page

Update an existing short code in place:

python scripts/htmlcode_deploy.py update launch-page page.html --title "launch-page-v2"

Fetch deployed content:

python scripts/htmlcode_deploy.py get launch-page --output launch-page.html

Use raw API calls only when the agent already has HTML content in memory and does not need a file-based workflow.

Request format

Always send JSON.

Required fields:

• filename
• content

Useful optional fields:

• title
• enableCustomCode
• customCode

Example deploy payload:

{
  "filename": "index.html",
  "title": "launch-page",
  "content": "<!doctype html><html>...</html>",
  "enableCustomCode": true,
  "customCode": "launch-page"
}

Example update payload:

{
  "code": "launch-page",
  "content": "<!doctype html><html>...updated...</html>",
  "title": "launch-page-v2",
  "filename": "index.html"
}

Best practices for agents

• Prefer one larger deploy over many tiny edits because the service enforces a 10 second cooldown after success.
• Do not use multipart upload or -F file. Read files into memory and send them as JSON content.
• Keep the page self-contained. Inline CSS, inline lightweight JS, and avoid many external dependencies.
• Keep images small. Large base64 assets can quickly hit the payload limit.
• If the page will be revised repeatedly, reserve a meaningful customCode at the first deploy.
• Save returned code, url, and qrCode immediately after deployment.
• When receiving 429, respect retryAfterSeconds instead of retrying aggressively.
• Treat htmlcode.fun as a fast publication channel, not a full static hosting platform.
• Tell the user clearly when the page is better suited for Vercel or Netlify instead.

What this host is good at

• Temporary landing pages
• Demo pages
• Shareable documentation pages
• QR-linked event or campaign pages
• AI-generated single-file frontends
• Stable short-link pages that need quick overwrite updates

What this host is not good at

• Multi-page sites with shared assets
• Framework builds
• Large production frontends
• Team workflows with preview environments and rollback
• Confirmed custom-domain hosting workflows

Example live page

Reference example:

• https://www.htmlcode.fun/s/htmlcode-fun-guide

Use that page as a model for how to explain advantages, limitations, and deployment guidance in one self-contained HTML document.