tools-boards
Build, rebuild or polish presentation-ready BluPlai whiteboards as native, editable shapes through the member's own BluPlai account, from a brief, a screenshot, a deck or a call transcript. Use for "make a board", "workshop board", "feedback wall", "turn this transcript into a board", "architecture map", "make this whiteboard look like this screenshot".
- License 许可
- MIT
- 最近更新
- 2026-11-06
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- tools-boards
- description
- Build, rebuild or polish presentation-ready BluPlai whiteboards as native, editable shapes through the member's own BluPlai account, from a brief, a screenshot, a deck or a call transcript. Use for "make a board", "workshop board", "feedback wall", "turn this transcript into a board", "architecture map", "make this whiteboard look like this screenshot".
02 资源文件 3
- 资产文件assets/release-workflow.example.json3.1 KB
- 参考文档references/design-language.md3.1 KB
- 参考文档references/mcp-contracts.md2.3 KB
03 SKILL.md 正文
BluPlai boards, made of real shapes
The member signs in to their own BluPlai account (bluplai.com). The plugin connects BluPlai's MCP server
(https://mcp.bluplai.com/mcp), and the first tool call opens BluPlai's sign-in in the browser. Never ask for or paste
a token. This skill is how we build boards: native shapes a team can drag, zones that say where work lands, a few
story arrows, and a check before anything is written.
The command
Claude Code: "${CLAUDE_PLUGIN_ROOT}/bin/tools-boards". Codex and Cursor: tools-boards (in ~/.local/bin).
| Command | What it does |
|---|---|
validate <scene.json> --payload <out.json> [--strict] |
Checks limits, overlaps, label fit and shape; writes the nodes and edges to send. |
sample <folder> |
Two practice scenes: a workshop runway (Northwind, fictional) and a teaching workflow with zones. |
Read references/design-language.md before laying out a scene, and references/mcp-contracts.md before a tool call.
Preflight
- Check the
bluplaitools are there. If not, the member connects it (Codex and Cursor: add the URL above as an MCP server) and signs in when asked. list_whiteboardsto find the target. Never guess a board id from a title.- Existing board:
read_whiteboardfirst. New board:create_whiteboard_map. Replace a whole board withreplace_whiteboard_maponly when the member asked to rebuild or overwrite it; it resets the live room.
From a call transcript to a board people can talk on
When the source is a call or a workshop (for example from tools-meetings), the board drives the next conversation:
- Read the whole transcript. Pull out the names, the questions, the promises and the decisions. Quote real lines, never invent them.
- Pick the shape: a workshop runway (question, evidence, synthesis, decision, owner), a feedback wall (what we heard, then an empty marked area for answers), a journey map or a decision board.
- Keep every label short (under about 32 characters per line, with deliberate line breaks).
- Leave clearly marked space for people to write back. End on a decision or a vote.
Compose in three passes
- Inventory. 12 to 28 meaningful nodes and 3 to 8 story arrows. Short stable ids. Large background zones carry
"role": "container"and come first in the list. - Layout. An 80 px rhythm, 24 px between cards, 48 to 80 px between clusters, roughly 16:9. Two or three meaning colours, not a rainbow: blue and semi for actors, violet for target zones, green for ready, orange or red with pattern for private or blocked, grey for evidence.
- Arrows last. Only the ones that tell the story. Verbs as labels: CHOOSE, REVIEW, PUBLISH.
Validate, write, verify
- Save the scene, then
validate scene.json --payload scene.mcp.json. Fix every error; review every warning. - Send the payload's nodes and edges with
create_whiteboard_map(or an authorised replace). read_whiteboardstraight after: the node and edge counts, the key labels and a new scene revision. A board that comes back as one image did not work.- The member opens it and zooms to fit (Shift+1). If labels clash, move coordinates and send one clean replacement.
- Public walkthrough: a view-only share link from BluPlai's Share dialog, with the expiry they asked for.
Rules
- Native shapes, not one big generated picture. Images only when the member wants a reference image kept.
- Boards often hold client material: check before sharing a link or filming one.
- Report the board name and link, revision, node and arrow counts, and any share-link expiry.
04 同仓库更多 Skills
your-voice
Help them build THEIR voice skill from their recordings and line edits. Use when they type /your-voice. Never install daniel-voice.
your-ops
Help them componentize THEIR invoice or ops template from a real document they sent. Use when they type /your-ops. Never ship NavAIgate letterhead or KG register facts.
your-brain
Help them start THEIR memory and keep it in step across machines. Use when they type /your-brain. Never install brain-sync or turso-search.
writing-style
Scrub AI slop from prose they are about to ship. Use when they type /writing-style, or when they ask to de-slop a draft. Voice itself is /your-voice — this skill is the editor.
web-scrape
Search the web semantically and pull clean content from pages, including JavaScript-heavy ones. Use whenever you need live web data during a task: finding docs, API references, code examples, articles, papers, or current info (Exa semantic search), or extracting the readable content of a specific URL — especially a JS-rendered, dynamic, or paywalled-by-script page a plain fetch returns empty (Firecrawl). Trigger even when the tools aren't named: "scrape this page", "search the web for", "pull the content from this URL", "find docs/articles about", "extract data from this site", "what does this page say", "research X online", "get me the latest on". Also bundles source clients — keyless Reddit (practitioner sentiment), Academic (OpenAlex papers + Unpaywall free PDFs, citations), Substack (newsletters, long-form), and paid Supadata (YouTube search + multi-platform transcripts) — plus a multi-source deep-research method: reach here for "what do people on Reddit say", "find research papers / citations on", "read this Substack / newsletter", "YouTube transcript", "video transcript", or "do a rigorous deep research pass on X".
transcripts
Pull YouTube, TikTok, Instagram or file transcripts via Supadata. Use when they type /transcripts or paste a video URL and want the words.