KeiSeiKit-1.0/skills/visual-explainer/commands/share.md
Parfii-bot a4e667de10 KeiSeiKit-public — clean state
Single-commit clean baseline after security scrub of niche-tells,
project codenames, internal jargon, and contributor-email leaks.

Contents:
- 100 Rust crates (_primitives/_rust/)
- 37 agent manifests (_manifests/) + generated specs (_generated/)
- 67 user-invocable skills (skills/)
- 33 hooks (hooks/)
- Composition blocks (_blocks/)
- Documentation (docs/, README.md)
- TS adapter packages (_ts_packages/)
- Assembler (_assembler/)
- Roles (_roles/)
- Templates (_templates/)
- Forgejo CI (.forgejo/)

Author: Denis Parfionovich <info@greendragon.info>

License: see LICENSE.
2026-05-01 12:09:03 +08:00

58 lines
1.4 KiB
Markdown

# Share Visual Explainer Page
Share a visual explainer HTML file instantly via Vercel. Returns a live URL with no authentication required.
## Usage
```
/share <file-path>
```
**Arguments:**
- `file-path` - Path to the HTML file to share (required)
**Examples:**
```
/share ~/.agent/diagrams/my-diagram.html
/share /tmp/visual-explainer-output.html
```
## How It Works
1. Copies your HTML file to a temp directory as `index.html`
2. Deploys via the vercel-deploy skill (no auth needed)
3. Returns a live URL immediately
## Requirements
- **vercel-deploy skill** - Should be pre-installed. If not: `pi install npm:vercel-deploy`
No Vercel account, Cloudflare account, or API keys needed. The deployment is "claimable" — you can transfer it to your Vercel account later if you want.
## Script Location
```bash
bash {{skill_dir}}/scripts/share.sh <file>
```
## Output
```
Sharing my-diagram.html...
✓ Shared successfully!
Live URL: https://skill-deploy-abc123.vercel.app
Claim URL: https://vercel.com/claim-deployment?code=...
```
The script also outputs JSON for programmatic use:
```json
{"previewUrl":"https://...","claimUrl":"https://...","deploymentId":"...","projectId":"..."}
```
## Notes
- Deployments are **public** — anyone with the URL can view
- Preview deployments have a configurable retention period (default: 30 days)
- Each share creates a new deployment with a unique URL