portable-html-port
Skill10 starsChanged 27 days agoMITView on GitHub
Port a built site or page into a single self-contained HTML file — CSS and JS inlined, small images base64-embedded, large ones flagged for CDN, source maps stripped — that pastes into any CMS or page-builder custom-HTML surface (WordPress, GoHighLevel, Webflow, Wix, Framer, Squarespace, Carrd, or generic) with no per-platform edits. Trigger when the user says "port to wordpress", "put this in ghl", "single-file html", "portable html", "make this embed-ready", "embed in webflow", or "wp port".
In this repository46 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- blast-promptSkill
- client-outreachSkill
- content-draftSkill
- copywritingSkill
- csv-to-reportSkill
- design-accessibilitySkill
- design-buildSkill
- design-croSkill
- design-dimensionsSkill
- design-motionSkill
- design-researchSkill
- design-system-genSkill
- design-system-persistSkill
- design-tokens-emitSkill
- design-visual-qaSkill
- html-extractSkill
- parallel-buildSkill
- qa-gateSkill
- route-codex-reviewSkill
- route-gemini-contextSkill
- route-three-brainSkill
- seo-auditSkill
- seo-backlinksSkill
- seo-clusterSkill
- seo-competitor-pagesSkill
- seo-content-briefSkill
- seo-contentSkill
- seo-dataforseoSkill
- seo-driftSkill
- seo-ecommerceSkill
- seo-firecrawlSkill
- seo-geoSkill
- seo-googleSkill
- seo-hreflangSkill
- seo-image-auditSkill
- seo-image-genSkill
- seo-local-unifiedSkill
- seo-pageSkill
- seo-programmaticSkill
- seo-schemaSkill
- seo-sitemapSkill
- seo-strategySkill
- seo-sxoSkill
- seo-technicalSkill
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 46
Handle warnings: If the file exceeds a platform cap (e.g.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
portable-html-port
Family: build-and-qa Status: Stable
Purpose
Convert a multi-file build (HTML + external CSS + external JS + local images) into a single self-contained HTML file that pastes into any CMS/page-builder custom-HTML surface with no per-platform tweaks. CSS and JS are inlined, small local images are base64-embedded, large ones are flagged for CDN hosting, and dev artifacts (source maps) are stripped.
Triggers
- "port to wordpress" / "wp port"
- "put this in ghl"
- "single-file html" / "portable html"
- "make this embed-ready"
- "embed in webflow"
Inputs
- Source build entry file (the HTML to port) and its asset folder
- Target platform hint (wordpress / ghl / webflow / wix / framer / squarespace / carrd / generic)
- Inline-image size threshold (KB) — images larger stay external
Steps
- Locate the entry HTML and confirm its CSS/JS/images are local (remote
http(s)://assets are left untouched on purpose). - Run the porter (try
python3, thenpyon Windows):python3 "${CLAUDE_PLUGIN_ROOT}/scripts/workflow/portable_html.py" \ --in <path/to/index.html> --out <portable.html> \ --target <platform> --inline-img-kb 50 --human - Read the report. It returns the output size, target-specific paste instructions, and warnings — including any images/JS left external and whether the file exceeds the target platform's inline-code limit.
- Handle warnings. If the file exceeds a platform cap (e.g. Webflow ~50KB, GHL ~5MB/element) or large images were left external, recommend CDN-hosting those assets and re-run, or switch to a mixed strategy.
- Verify the output renders standalone (open it / spot-check), then deliver it with the target-specific paste instructions from the report.
Outputs
portable.html— the single-file bundle- A size + warnings report (JSON, or
--humantext) with paste instructions - A list of any assets left external (to host on a CDN)
Dependencies
scripts/workflow/portable_html.py(required) — Python 3.10+, standard library only- Browser or Playwright (optional — adds an automated standalone-render check; free path: open the output file and spot-check manually)
Notes
Platform quirks the output respects (the script encodes the size limits and paste guidance per target):
- WordPress (Gutenberg Custom HTML block / Elementor HTML widget) — supports
<style>+<script> - GoHighLevel — Custom Code element; watch per-element size; CDN large media
- Webflow — custom-code embeds cap near 50KB; prefer external/CDN assets
- Wix — HTML iframe; isolated context, JS can't reach the parent page
- Framer / Squarespace — full HTML+CSS+JS embed support
- Carrd — Embed element (Code type); requires a Carrd Pro plan
Sample source input lives in references/examples/portable-html/src/.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

