beam-ai-team/miro-connect
skills/integrations/miro/miro-connect/SKILL.md
Connect to Miro for board management, sticky notes, cards, shapes, frames, connectors, and collaboration. Load when user mentions 'miro', 'miro board', 'sticky note', 'whiteboard', or any Miro operations. Meta-skill that validates config and routes to appropriate operations.
testing
Updated May 13, 2026
$ install --global
skillsauthnpx skillsauth add beam-ai-team/beam-next-skills miro-connectInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 13, 2026, 4:01 AM153.8s1 file scanned
SKILL.md
- name:
- miro-connect
- version:
- 1.0
- description:
- Connect to Miro for board management, sticky notes, cards, shapes, frames,
- author:
- Mujtaba
- category:
- integrations
- platform:
- Miro
- updated:
- 2026-03-12
- visibility:
- public
Miro Connect
Entry point for all Miro operations. Validates configuration and routes requests to appropriate scripts.
Trigger Phrases
Load this skill when user says:
- "miro" / "connect miro" / "miro connect"
- "miro board" / "list boards" / "create board"
- "sticky note" / "add sticky" / "create card on miro"
- "whiteboard" / "miro frame"
- Any reference to Miro operations
Quick Reference
Check configuration:
python3 00-system/skills/miro/miro-master/scripts/check_miro_config.py --json
Workflow
Step 1: Validate Configuration
Always run first:
python3 00-system/skills/miro/miro-master/scripts/check_miro_config.py --json
If ai_action is proceed_with_operation:
- Continue to Step 2
If ai_action is add_access_token:
- Tell user: "Miro needs an access token. Add MIRO_ACCESS_TOKEN to your .env file."
- Guide them to https://developers.miro.com to create an app and get a token
If ai_action is refresh_token:
- Tell user: "Your Miro token may be expired. Please generate a new one."
Step 2: Identify User Intent
| User Says | Route To | |-----------|----------| | "list miro boards" | Boards > list_boards.py | | "get board details" | Boards > get_board.py | | "create a board" | Boards > create_board.py | | "delete board" | Boards > delete_board.py | | "copy board" | Boards > copy_board.py | | "list items on board" | Items > list_items.py | | "add sticky note" | Items > create_sticky_note.py | | "create card" | Items > create_card.py | | "add shape" | Items > create_shape.py | | "add text" | Items > create_text.py | | "create frame" | Items > create_frame.py | | "connect items" | Items > create_connector.py | | "add image" | Items > create_image.py | | "embed URL" | Items > create_embed.py | | "move/update item" | Items > update_item.py | | "delete item" | Items > update_item.py --delete | | "board members" | Members > board_members.py --list | | "invite to board" | Members > board_members.py --add | | "manage tags" | Tags > tags.py |
Step 3: Execute Operation
Use the appropriate script from miro-master/scripts/:
Board Operations
List boards:
python3 00-system/skills/miro/miro-master/scripts/list_boards.py --limit 20 --json
Get board:
python3 00-system/skills/miro/miro-master/scripts/get_board.py --board "BOARD_ID" --json
Create board:
python3 00-system/skills/miro/miro-master/scripts/create_board.py --name "Board Name" --description "Description" --json
Delete board:
python3 00-system/skills/miro/miro-master/scripts/delete_board.py --board "BOARD_ID" --json
Copy board:
python3 00-system/skills/miro/miro-master/scripts/copy_board.py --board "BOARD_ID" --json
Item Operations
List items:
python3 00-system/skills/miro/miro-master/scripts/list_items.py --board "BOARD_ID" --type sticky_note --json
Create sticky note:
python3 00-system/skills/miro/miro-master/scripts/create_sticky_note.py --board "BOARD_ID" --content "Note text" --color yellow --x 0 --y 0 --json
Create card:
python3 00-system/skills/miro/miro-master/scripts/create_card.py --board "BOARD_ID" --title "Title" --description "Desc" --json
Create shape:
python3 00-system/skills/miro/miro-master/scripts/create_shape.py --board "BOARD_ID" --content "Text" --shape rectangle --width 200 --height 200 --json
Create text:
python3 00-system/skills/miro/miro-master/scripts/create_text.py --board "BOARD_ID" --content "Text here" --font-size 24 --json
Create frame:
python3 00-system/skills/miro/miro-master/scripts/create_frame.py --board "BOARD_ID" --title "Section" --width 800 --height 600 --json
Create connector:
python3 00-system/skills/miro/miro-master/scripts/create_connector.py --board "BOARD_ID" --start-item "ITEM1" --end-item "ITEM2" --shape curved --json
Create image:
python3 00-system/skills/miro/miro-master/scripts/create_image.py --board "BOARD_ID" --url "https://example.com/img.png" --json
Create embed:
python3 00-system/skills/miro/miro-master/scripts/create_embed.py --board "BOARD_ID" --url "https://example.com" --json
Update/move item:
python3 00-system/skills/miro/miro-master/scripts/update_item.py --board "BOARD_ID" --item "ITEM_ID" --x 100 --y 200 --json
Delete item:
python3 00-system/skills/miro/miro-master/scripts/update_item.py --board "BOARD_ID" --item "ITEM_ID" --delete --json
Get item details:
python3 00-system/skills/miro/miro-master/scripts/update_item.py --board "BOARD_ID" --item "ITEM_ID" --get --json
Member Operations
List members:
python3 00-system/skills/miro/miro-master/scripts/board_members.py --board "BOARD_ID" --list --json
Add member:
python3 00-system/skills/miro/miro-master/scripts/board_members.py --board "BOARD_ID" --add "[email protected]" --role editor --json
Tag Operations
List tags:
python3 00-system/skills/miro/miro-master/scripts/tags.py --board "BOARD_ID" --list --json
Create tag:
python3 00-system/skills/miro/miro-master/scripts/tags.py --board "BOARD_ID" --create "Tag Name" --color red --json
Attach tag to item:
python3 00-system/skills/miro/miro-master/scripts/tags.py --board "BOARD_ID" --attach TAG_ID --item ITEM_ID --json
Step 4: Handle Results
Success:
- Display relevant information to user
- Format board names, item IDs, member names nicely
Error:
- Common errors:
401> Token expired or invalid403> Insufficient permissions404> Board or item not found429> Rate limited, wait and retry
Board ID Resolution
When user references a board by name:
- List boards:
list_boards.py --json - Find matching board in response
- Use the board ID for operations
Environment Variables
Required in .env:
MIRO_ACCESS_TOKEN=your-access-token
Optional (for OAuth refresh):
MIRO_CLIENT_ID=your-client-id
MIRO_CLIENT_SECRET=your-client-secret
Related Resources
- API Reference:
miro-master/references/api-reference.md - Scripts:
miro-master/scripts/
Version: 1.0 Created: 2026-03-12 Status: Production Ready
Related Skills
beam-ai-team/skills/general/taste-skill
development
VerifiedTrustedCommunity
--- name: taste-skill type: skill version: '1.0' author: Leonxlnx (packaged by Zhichao Li) category: general tags: - frontend - design - anti-slop - landing-page updated: '2026-06-11' visibility: public description: Anti-slop frontend skill for landing pages, portfolios, and redesigns. The agent reads the brief, infers the right design direction, and ships interfaces that do not look templated. Real design systems when applicable, audit-first on redesigns, strict pre-flight check. license: MIT.
SKILL.mdUpdated Jun 12, 2026
beam-ai-team/numbers
development
VerifiedTrustedCommunity
Use when communicating quantitative information in any form — Slack updates, emails, reports, decks, dashboards, landing pages, product UI, public talks. Covers two integrated layers: (1) making numbers semantically meaningful (translation, anchoring, simplification, story-pairing) and (2) showing numbers cleanly (chart vs table vs prose, chart-by-message, pre-attentive emphasis, color discipline, decluttering). Distilled and integrated from *Show Me the Numbers* (Stephen Few) and *Make Numbers Count* (Chip Heath & Karla Starr). Not for raw data analysis or statistics — this is about communication of numbers, not their derivation.
SKILL.mdUpdated Jun 12, 2026
beam-ai-team/impeccable
development
VerifiedTrustedCommunity
Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.
SKILL.mdUpdated Jun 12, 2026
beam-ai-team/beam-teach
tools
VerifiedTrustedCommunity
Stateful multi-session tutor adapted for Beam — teach a stakeholder to understand, trust, and operate a specific agent, or teach a Solution Engineer a client's business process for delivery. Grounds every lesson in Knowledge Hub sources (real agent graphs, real tasks, transcripts, Linear) before any web resource. Also works for any general topic. Trigger on "teach me", "beam teach", "教我", "onboard <person> on <agent>", "help <stakeholder> understand the agent", "learn this client's process".
SKILL.mdUpdated Jun 12, 2026