feat(skills): add miro-format, scope widget skills to boards (CM-8232) - #65
Open
stanislavBolsun wants to merge 2 commits into
Open
feat(skills): add miro-format, scope widget skills to boards (CM-8232)#65stanislavBolsun wants to merge 2 commits into
stanislavBolsun wants to merge 2 commits into
Conversation
The doc/diagram/table skills only pointed at the widget-creation tools, so requests for a brand-new standalone item (e.g. "create a doc in Miro about X") always routed to the widget tool instead of board_create_format, since skill selection happens on the description field before any tool description is read. Add miro-format as the standalone-format counterpart and scope the widget skills to "adding onto an existing board" with a cross-reference to it.
stanislavBolsun
marked this pull request as ready for review
September 2, 2026 15:08
Fast-reviewer caught three spots left inconsistent after adding the miro-format skill: README.md's Quick Start blurb still listed 7 skills without format, CONTRIBUTING.md's Gemini extension tree comment still said "7 skills", and the plugin's own README Components table was still listing only 6 skills (missing both miro-format and the pre-existing miro-code-explain-on-board gap).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Motivation
The Miro MCP server exposes both widget-adding tools (
doc_create,diagram_create,table_create— add content onto an existing board) and aboard_create_formattool that creates a document/table/diagram/timeline/kanban/etc. as its own standalone format, not tied to an existing
board. The
miro-doc,miro-diagram, andmiro-tableskills only pointedat the widget-creation tools, so a request like "create a doc in Miro about
X" always routed to the widget tool — skill routing happens on the
SKILL.mdfrontmatterdescriptionfield, before any MCP tool descriptionis ever read, so there was no way to reach the standalone-format tool.
Proposed changes
miro-formatskill as the standalone-format counterpart tomiro-doc/miro-diagram/miro-table, routing to the MCP server'sstandalone format-creation tools (document, table, diagram, timeline,
kanban, slide deck, prototyping container, activities board, embed).
miro-doc,miro-diagram, andmiro-table'sdescriptionfrontmatter to "adding onto a board you're already working on," each with
a "When not to use this skill" cross-reference pointing to
miro-format.miroplugin version1.3.0→1.4.0inplugin.jsonandmarketplace.json.README.md,CLAUDE.md,CONTRIBUTING.md, and thedocs/vendor pages(
docs/claude-code/miro.md,docs/agent-skills/overview.md,docs/gemini-cli/overview.md,docs/mcp/tools-reference.md).codex-plugins/,cursor-plugins/,copilot-cowork-plugins/,skills/,gemini-extension.json) viabun run convertfrom the single source of truth underclaude-plugins/miro/skills/.Unrelated changes (optional)
None
Testing / Validation
bun run validatepasses (plugin.json schema, SKILL.md frontmatter,MCP consistency, Codex/Cowork manifest checks).
codex-plugins/,cursor-plugins/,copilot-cowork-plugins/,skills/, andgemini-extension.jsonare byte-identical to the source underclaude-plugins/miro/skills/afterbun run convert.Notes (optional)
None
Dependencies (optional)
None