Learn how to extract Miro specifications to local files and use them for AI-assisted planning and implementation. Use when working with Miro specs or when user wants to download board content for reference.
Extracts Miro board specifications to local files for AI-assisted planning and implementation.
npx claudepluginhub miroapp/miro-aiThis skill inherits all available tools. When active, it can use any tool Claude has access to.
references/spec-storage.mdThe miro-spec plugin extracts specification content from Miro boards and saves it to local files. This enables AI to reference specs during planning and implementation without requiring repeated API calls.
Use miro-spec when you need to:
Extract specs from a Miro board or item:
/miro-spec:get [url]
Board URLs - Extract all spec items:
https://miro.com/app/board/uXjVK123abc=/
Item URLs - Extract single item:
https://miro.com/app/board/uXjVK123abc=/?moveToWidget=3458764612345
.miro/specs/
├── documents/ # Miro documents (Markdown format)
├── diagrams/ # Diagram descriptions (Markdown)
├── prototypes/ # Prototype containers (Markdown) and screens (HTML)
├── tables/ # Table data (JSON)
├── frames/ # Frame summaries (Markdown)
├── other/ # Unknown types like slides (Markdown)
├── images/ # Downloaded images (PNG)
└── index.json # Metadata index
Documents (.md)
Diagrams (.md)
Prototypes (.md / .html)
.md, suffix -container).html, suffix -screen)Tables (.json)
Frames (.md)
Images (.png)
/miro-spec:get https://miro.com/app/board/uXjVK-spec=/
If .miro/specs/ already has files, choose:
Output shows:
Extracted 5 documents, 3 diagrams, 2 prototypes, 1 table
Downloaded 12 images
Saved to .miro/specs/
Open .miro/specs/index.json to see:
When to use:
What it does:
Example:
/miro-spec:get https://miro.com/app/board/uXjVK123abc=/
When to use:
What it does:
moveToWidget parameterExample:
/miro-spec:get https://miro.com/app/board/uXjVK123abc=/?moveToWidget=3458764612345
src attributesOriginal HTML:
<img src="https://miro.com/api/v2/boards/uXjVK123abc=/images/3458764612345"/>
After extraction:
<img src="../images/3458764612345.png"/>
Extract specs:
/miro-spec:get https://miro.com/app/board/uXjVK-product-spec=/
Review what was extracted:
Check .miro/specs/index.json to see available specs
Ask AI to plan implementation: "Based on the specs in .miro/specs/, create an implementation plan for the user authentication feature"
AI reads relevant files: AI automatically reads documents, diagrams, and tables during planning
Implement with context: AI uses spec content to guide code generation
Planning with specs:
"Review the product requirements in .miro/specs/documents/ and create a technical implementation plan"
Using specific diagrams:
"Reference the architecture diagram in .miro/specs/diagrams/3458764612345.md and implement the database schema"
Validating implementation:
"Compare the authentication flow I implemented against the spec in .miro/specs/prototypes/3458764612346.html"
.miro/specs/ in .gitignore if specs are temporaryindex.json first to understand what's available# Extract all PRD documents
/miro-spec:get https://miro.com/app/board/uXjVK-prd=/
# Review extracted docs
cat .miro/specs/index.json | grep documents
# Plan implementation
"Plan implementation based on requirements in .miro/specs/"
# Extract updated design doc
/miro-spec:get https://miro.com/app/board/uXjVK=/.../?moveToWidget=3458764612345
# Choose "Add to existing" when prompted
# Review changes in .miro/specs/documents/3458764612345.html
# Extract board with diagrams
/miro-spec:get https://miro.com/app/board/uXjVK-architecture=/
# Check diagram summaries
ls .miro/specs/diagrams/
cat .miro/specs/diagrams/*.md
No items extracted from board:
Images not downloading:
Files not found after extraction:
.miro/specs/index.json for actual pathsLarge boards taking too long:
This skill should be used when the user asks about libraries, frameworks, API references, or needs code examples. Activates for setup questions, code generation involving libraries, or mentions of specific frameworks like React, Vue, Next.js, Prisma, Supabase, etc.