convez.ai
SkillDesenvolvimento WebIntermediário
lxhsoluto-star

HTML Share Skill

lxhsoluto-star/html-share-skill

Transforme HTML em URL curta + QR code com preview social automático

Ver no GitHub
InicialPluginScore · de 0 a 100

Converte um arquivo HTML em URL curta + código QR com um único comando. Processa imagens locais automaticamente, gera preview social 1200×630, injeta metadados OG/Twitter e oferece links personalizados para usuários verificados. Integra-se com Claude Code e agents via backend em sharehtml.net.

Instalação

$npx convez-ai lxhsoluto-star/html-share-skill

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Compartilhar relatórios e dashboards HTML gerados por agents
  • Gerar links verificáveis para protótipos e mockups com preview em chats
  • Criar compartilhamentos com expiração e proteção por senha
  • Distribuir documentos HTML interativos com código QR scanável

Veredito

Skill bem construída que resolve um problema real — compartilhar HTML dinâmico com metadados ricos. Excelente para agents que geram relatórios; backend robusto em sharehtml.net com tier gratuito funcional (7 dias) e verificado pago. Dependência em bun é leve e esperada.

README

A tradução para o português deste README ainda está na fila.

html-share skill

🌐 Homepage: sharehtml.net

Turn a single-page HTML file into a short URL + QR code from your terminal or agent. Local images are uploaded (or inlined when tiny) and their references rewritten automatically; a mobile viewport is added if missing; a 1200×630 social-preview image is generated and OG/Twitter meta injected so the link shows a thumbnail when pasted into chat apps. Verified users can pick a custom short link.

This is a Claude Code / agent skill. It talks to the hosted backend at sharehtml.net (or your own, via --api-base). The only prerequisite is a bound email.

The terminal output above is real (--pretty). Agents get the same result as a single JSON line; --pretty is just the human-readable rendering.

Install

With the skills CLI (recommended):

npx skills add lxhsoluto-star/html-share-skill

This installs the skill into your agent's skills directory (~/.claude/skills/ for Claude Code). List or update later with npx skills list / npx skills update.

Manual:

git clone https://github.com/lxhsoluto-star/html-share-skill ~/.claude/skills/html-share
# or clone anywhere and symlink the folder into your .claude/skills directory

Prerequisites

  • bun (or npx -y bun — the skill auto-resolves whichever is available).

  • One-time dependency install:

    cd scripts && bun install   # linkedom, qrcode, satori, @resvg/resvg-wasm
    

The Latin OG font (Inter) is bundled in scripts/fonts/; CJK glyphs are fetched on demand when a title needs them.

Setup — bind an email (the only gate)

bun scripts/main.ts register --email you@example.com

You can share immediately as the unverified tier (7-day expiry, low quota, no password). To unlock the verified tier (password protection, expiry up to 90 days, custom short links, higher quota), sign in once at the dashboard with the same email — a 6-digit code is emailed to you.

Your email + a CLI token are stored in EXTEND.md next to SKILL.md. The token is a secret — EXTEND.md is gitignored.

Usage

# Share an HTML file (the common case)
bun scripts/main.ts ./report.html

# Update the share previously made from this file (keeps the URL + QR)
bun scripts/main.ts ./report.html --update

# Force a brand-new link
bun scripts/main.ts ./report.html --new

# Verified tier: password / expiry / custom short link
bun scripts/main.ts ./report.html --password "s3cret" --expiry 30
bun scripts/main.ts ./launch.html --slug q3-launch

Options

OptionDescriptionDefault
<path.html>Path to the HTML file to sharerequired
register --email <e>Bind an email (first-time setup)
--updateUpdate the share made from this file (stable URL/QR)
--newForce a new share even if shared before
--password <p>Password-protect (verified tier)
--remove-passwordRemove a password (with --update)
--expiry <days>Expiry in days (verified; clamped to 90)tier default
--slug <name>Custom short link (verified; 3–48 a-z0-9-; new shares only)random
--og-title <text>Title shown on the social-preview cardpage <title>
--no-ogSkip social-preview image generation
--no-qrSkip QR rendering
--no-mobile-fixDon't inject the responsive baseline
--inline-threshold <bytes>Inline assets ≤ this size as data URIs4096
--output-dir <dir>Base output folderhtml-share
--api-base <url>Override backend base URLfrom EXTEND.md
--prettyHuman-readable output (link + QR + card) instead of JSONJSON

Remote references (http(s)://, //, data:) are never modified — only local files are uploaded or inlined.

Output

html-share/
├── .index.json                 # docHash / sourcePath → share mapping
└── {basename}-{slug}/
    ├── processed.html          # exact HTML shared (asset URLs resolved)
    ├── result.json             # { slug, url, qrUrl, expiresAt, tier, ... }
    ├── qr.png
    └── qr.svg

.index.json is keyed by content hash and source path, so re-running on the same file reuses the prior link (or offers --update).

Error codes

The script prints a single JSON line on stdout. status: "ERROR" carries an error code:

errorMeaning / action
NEEDS_EMAILNo bound email → run register
TOKEN_INVALID (401)Token revoked/expired → re-register
QUOTA_EXCEEDED (403)Tier quota hit → verify (dashboard sign-in) or delete old shares
PASSWORD_NOT_ALLOWED (403)Password needs verified tier → verify via dashboard sign-in
PAYLOAD_TOO_LARGE (413)Over per-share size limit
NOT_HTMLInput isn't an .html file
BAD_ASSETA referenced asset has a disallowed type
SLUG_TAKEN (409)Requested --slug already exists
SLUG_INVALID (400)--slug isn't 3–48 a-z0-9-, or is reserved
SLUG_NOT_ALLOWED (403)Custom slug needs verified tier → verify via dashboard sign-in
BLOCKED_CONTENT (422)Rejected by abuse detection (phishing/malware) — don't retry
DISPOSABLE_EMAIL (400)Disposable email at register → use a real address

Backend & privacy

  • Defaults to the hosted backend https://sharehtml.net. Any backend that implements the same API can be used instead — point the skill at it with --api-base (or set api_base in EXTEND.md).
  • Shared pages are served from an isolated content origin (view.sharehtml.net), not the app origin.
  • EXTEND.md holds your email + CLI token (a secret) and is gitignored.

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados