Html2link publish

Skill joohw/html2link-skill/html2link-publish

Agent Skill for publishing HTML, docs, decks, spreadsheets, and static sites to html2link.dev share links

Install

npx -y skills add joohw/html2link-skill --skill html2link-publish

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Publish generated artifacts to html2link.dev and return short shareable URLs. Use when Codex or another agent creates an HTML file, static site ZIP, PDF, Markdown document, spreadsheet, DOCX, or PPTX and needs to give the user a browser-friendly link instead of only a local file path or attachment.

SKILL.md

3.5 KB, as published. Nobody here has run it

html2link Publish

Overview

Use html2link to turn local artifacts into short links that open directly in a browser. Prefer this skill after creating a report, prototype, dashboard, presentation, document, static site, or other deliverable that the user may want to view or share.

Supported Inputs

.html, .htm
.zip static sites that contain index.html; archives with one top-level folder are normalized by html2link
.pdf
.md, .markdown
.xlsx, .xls, .csv
.docx
.pptx

Publish Workflow

Write the artifact to a stable local file path.
If the artifact is a static site, package it as a ZIP with index.html at the root when possible.
Upload the file with scripts/publish-html2link.mjs or an equivalent curl request.
Return only the public url field to the user unless they ask for API details.
Treat updateToken as private. Store or show it only when the user explicitly wants to update or delete the same link later.

Script

Run the bundled script from the skill directory or with an absolute path:

node scripts/publish-html2link.mjs /absolute/path/to/report.html

The script prints the JSON API response. It reads these optional environment variables:

HTML2LINK_BASE_URL: Defaults to https://html2link.dev
HTML2LINK_API_TOKEN: Bearer token for files over the anonymous limit

Update an existing link:

node scripts/publish-html2link.mjs /absolute/path/to/report.html --slug a1B2c3D4 --update-token keep-this-private

Delete a link:

node scripts/publish-html2link.mjs --delete --slug a1B2c3D4 --update-token keep-this-private

Direct API

Upload with multipart field file:

curl -F "file=@/absolute/path/to/report.html" https://html2link.dev/api/upload

For files above 1 MB, include a signed-in user's API token:

curl -H "Authorization: Bearer $HTML2LINK_API_TOKEN" -F "file=@/absolute/path/to/report.pptx" https://html2link.dev/api/upload

Successful response:

{
  "slug": "a1B2c3D4",
  "updateToken": "keep-this-private",
  "url": "https://html2link.dev/x/a1B2c3D4",
  "kind": "html",
  "size": "42 KB",
  "updated": false
}

Update an existing link:

curl -F "slug=a1B2c3D4" -F "updateToken=keep-this-private" -F "file=@/absolute/path/to/report.html" https://html2link.dev/api/upload

Delete an existing link:

curl -X DELETE -H "Content-Type: application/json" -d '{"slug":"a1B2c3D4","updateToken":"keep-this-private"}' https://html2link.dev/api/upload

Limits And Errors

Anonymous uploads are free up to 1 MB.
Authenticated uploads are supported up to 100 MB.
If the API returns requiresLogin: true, tell the user the file is over the anonymous limit and needs authenticated publishing with HTML2LINK_API_TOKEN.
If upload fails, report the HTTP status and response body. Do not invent a link.
If publishing sensitive or private material, confirm that the user wants a public share link before uploading.

User Response

Keep the response concise:

Published: https://html2link.dev/x/a1B2c3D4

Mention the local file path only when it is useful for follow-up work.