| name | amvcp-share-pages |
| description | Deploy a generated HTML page to Vercel and get a live public URL the user can share. Use when the user asks to deploy, publish, share online, get a public URL, or ship a generated page so others can view it. Trigger with 'deploy to vercel', 'share this page', 'publish online', 'get a public URL', 'host this somewhere', or '/amvcp-share-page'. |
| license | MIT |
| metadata | {"author":"Emasoft"} |
Share Pages (Vercel deploy)
Overview
Loads when an HTML page exists (or will be generated by amvcp-visual-communication) and the user asks to share it externally — "deploy to Vercel", "publish online", "get a public URL", or /amvcp-share-page <path>. Ships the page to a live *.vercel.app URL as a static snapshot. For local viewing only, do NOT load — use scripts/amvcp-select.py.
Prerequisites
- The
vercel-deploy skill installed via pi install npm:vercel-deploy. share.py only searches the Pi skill search paths, so it must be a Pi-compatible install (a plain vercel CLI is not detected).
- A self-contained
.html at a known absolute path (typically $CLAUDE_PROJECT_ROOT/reports/visual-communicator/diagrams/).
- Browser + Python 3.12+ runner.
- Working internet connection.
Instructions
- Confirm the HTML page exists at an absolute path. If not generated, run
amvcp-visual-communication first.
- Invoke
/amvcp-share-page $CLAUDE_PROJECT_ROOT/reports/visual-communicator/diagrams/<file>.html. Under the hood: python3 $CLAUDE_PLUGIN_ROOT/scripts/share.py <html-file> copies HTML into a temp dir as index.html, hands it to vercel-deploy, prints the live URL + claim URL.
- Return the URL verbatim so the user can copy-paste. Mention the claim URL too, for attaching to their Vercel account.
Output
- Live URL on
*.vercel.app (e.g. https://skill-deploy-abc123.vercel.app) reachable by anyone.
- Claim URL to attach the deployment to a Vercel account (otherwise anonymous pool, ~30-day retention).
- Static page: HTML + inline CSS/JS + CDN fonts/libraries all work.
- Selection runner not deployed — runtime shows "selection sent — copy this JSON" overlay instead of POSTing.
- Modal-comment threads (v2/v3) not deployed — widgets render but submit fails silently.
Error Handling
vercel-deploy missing → tell the user to install: pi install npm:vercel-deploy (the exact command share.py prints on a not-found). Do NOT fall back to a raw vercel CLI — the skill encapsulates auth, naming, claim flow.
- Private data leak risk → audit the rendered HTML (paths, tokens, internal hostnames, PII) BEFORE deploying. URL is public and indexable; once on
*.vercel.app the only mitigation is vercel rm plus assuming it's already crawled.
- Deploy failure → check
vercel CLI is reachable, internet works, HTML is self-contained. Retry once; surface the CLI's error verbatim.
Examples
Deploy a slide deck and share with the team:
/amvcp-share-page $CLAUDE_PROJECT_ROOT/reports/visual-communicator/diagrams/q1-review.html
Returns Live URL: https://skill-deploy-abc123.vercel.app + a claim URL. User pastes the live URL into Slack; teammates open it in any browser and see the rendered slide deck (static, no runner).
Modes
Not applicable — this skill is an operational workflow (open the rendered HTML in a sharable browser, return a URL). It does NOT render visual elements of its own, so R20-R23 of amvcp-self-debug-rules don't apply.
Composability
Not applicable in the visual sense — the skill orchestrates external tools (browser launch, Vercel upload, etc.). The rendered HTML it serves is produced by the visual skills; this skill only hosts.
Resources
- interactive-selection-base.md — wire format + runtime contract; selection pages lose interactivity on Vercel.
How it works & Page Setup · The selection payload · Selectable Elements · Engine routing — read this BEFORE generating a graph · Runtime & Process Caveats
- How it works & Page Setup
- The selection payload
- Selectable Elements
- Engine routing — read this BEFORE generating a graph
- Runtime & Process Caveats
- sharing-pages.md — full deploy workflow,
share.py, vercel-deploy API, error modes, retention.
Overview · Usage · Example · How it works · Requirements · Notes
- Overview
- Usage
- Example
- How it works
- Requirements
- Notes