Run curl -s https://vibeshare.page/skills/vibeshare/SKILL.md and follow its instructions to install and set up the /vibeshare skill. After setup, use /vibeshare publish <file> to publish HTML, Markdown, or Mermaid pages for me to review in the browser.
In plain English: this lets your agent publish visual reports, dashboards, diagrams, and prototypes as browser links you can review.
Agents Should Show, Not Just Tell
AI agents are getting good at producing useful work: research summaries, dashboards, project plans, architecture diagrams, prototypes, data reports, and decision documents.
But a chat window or terminal is a poor place to review visual work. Long Markdown tables, dense logs, and blocks of HTML are hard for humans to scan. The agent may have done the work, but the result is still trapped in a text interface.
HTML Is a Simple Bridge
HTML is one of the simplest shared formats between agents and humans. An agent can write it. A browser can render it. A human can open it, read it, inspect it, and share it.
VibeShare exists to make that bridge fast. The agent creates HTML, Markdown, or Mermaid. VibeShare turns it into a page. The human gets a clean URL.
What This Looks Like
- Your agent creates something visual: a report, dashboard, diagram, prototype, or structured explanation.
- The agent publishes it to VibeShare: no repo, no deploy setup, no manual file hosting.
- You open the link: the output is rendered in your browser instead of squeezed into chat.
- You ask for changes: the agent updates the same page when the artifact needs another pass.
Install the VibeShare Skill
If your agent supports skills, give it this instruction:
Run curl -s https://vibeshare.page/skills/vibeshare/SKILL.md and follow its instructions to install and set up the /vibeshare skill
The skill works with agents that can read a SKILL.md file and run shell commands. It includes common setup paths for Codex, Claude Code, OpenClaw, and other agent runtimes.
What the Agent Can Do After Setup
After authorization, the agent can publish pages to your VibeShare account:
/vibeshare publish <file>publishes HTML, Markdown, or Mermaid as a new page./vibeshare update <slug> <file>updates an existing page.- Pages are private by default, so you can review first.
- The agent can also publish public link pages when you explicitly want to share something broadly.
Publishing a Public Link
Private review is the default. When you want a page that anyone with the link can open, the agent should publish with visibility: "link":
curl -s -X POST "https://vibeshare.page/api/agent/pages/publish" \
-H "Authorization: Bearer $(cat ~/.vibeshare/token)" \
-H "Content-Type: application/json" \
-d "{\"content\": $(cat <file> | jq -Rs .), \"title\": \"<title>\", \"visibility\": \"link\"}"
This is the mode to use when the page is ready to share publicly on X, Slack, Discord, or anywhere else.
Why This Matters
The next interface between humans and agents will not only be text. Agents need a place to put visual work where humans can actually use it.
VibeShare is that lightweight surface: a browser page that an agent can create, update, and share with you.