agent-whiteboard

Publish and manage Markdown, HTML, and image whiteboards via the Agent Whiteboard CLI.

Updated Jun 24, 2026
One-click install
npx skills add https://github.com/dndplsidc/agent-whiteboard --skill agent-whiteboard-dndplsidc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-whiteboard
Source: https://github.com/dndplsidc/agent-whiteboard/tree/main/skills/agent-whiteboard
Command: npx skills add https://github.com/dndplsidc/agent-whiteboard --skill agent-whiteboard-dndplsidc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Sharing agent-generated reports, diagrams, and prototypes as browsable pages requires manual hosting and link management. This Skill lets an agent publish, update, retrieve, and delete Markdown, Mermaid, HTML, and raster image resources through the Agent Whiteboard CLI, returning shareable capability URLs with controlled expiration. ## Core Features & Use Cases - Publishing workflow: Create Markdown, trusted standalone HTML, and PNG/JPEG/GIF/WebP image resources with mandatory creator context, title, and summary metadata, using structured JSON output. - Local catalog discovery: Search this laptop's metadata-only history of previously created boards with catalog list before creating duplicates or asking for known URLs. - Lifecycle management: Update content while preserving capability URLs and expiration, retrieve exact source and context, and delete resources to revoke access. - Safety and size controls: Strip secrets before publishing, respect the 500,000-byte Page Agent authoring budget, and recover correctly from catalog warnings like catalog_write_failed and creation_uncertain. - Use Case: Turn an incident report with Mermaid diagrams into a published page expiring in seven days, then return the verified absolute URL to share with teammates. ## Quick Start Use agent-whiteboard to publish this Markdown report with its diagram as a page expiring in one hour and give me the verified URL.

Frequently Asked Questions about agent-whiteboard

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I publish a Markdown report as a shareable page with Agent Whiteboard?

Run `agent-whiteboard --json create markdown` with a non-empty creator-context file, title, and summary. Upload any local images first and replace their paths with the returned absolute URLs, then verify the published page and report its capability URL and expiration.

How do I find a whiteboard I published earlier?

Use `agent-whiteboard --json catalog list --query "terms"` to search this laptop's local metadata history by title and summary. The catalog is offline and excludes images and boards created on other devices, so an empty result does not prove the board never existed.

Can I publish SVG images or external scripts to Agent Whiteboard?

No. Only PNG, JPEG, GIF, and WebP images are accepted, and SVG is rejected. Standalone HTML must be fully self-contained with no external scripts, stylesheets, fonts, or runtime network calls.

Is a capability URL a private link for sensitive content?

No. A capability URL is a bearer credential: anyone holding it can view, retrieve, update, or delete the resource. Never publish credentials, tokens, personal data, or confidential source, since `noindex` only reduces discovery and is not access control.

What happens when publishing succeeds but a catalog warning appears?

A `catalog_write_failed` warning means the remote resource exists but the local record was not saved; preserve the returned URL and never repeat create, which could duplicate the board. For `creation_uncertain`, use the returned URL with existing `get` or `delete` recovery.

What is the size limit for pages used with Page Agent?

The recommended authoring budget is 500,000 combined UTF-8 bytes for source plus creator context. Larger content should be split into linked boards with images uploaded separately, since Page Agent sends the full source and context on the initial turn.