Skip to content

feat(skills): add miro-format, scope widget skills to boards (CM-8232) - #65

Open
stanislavBolsun wants to merge 2 commits into
miroapp:mainfrom
stanislavBolsun:CM-8232
Open

feat(skills): add miro-format, scope widget skills to boards (CM-8232)#65
stanislavBolsun wants to merge 2 commits into
miroapp:mainfrom
stanislavBolsun:CM-8232

Conversation

@stanislavBolsun

@stanislavBolsun stanislavBolsun commented Sep 2, 2026

Copy link
Copy Markdown

Motivation

The Miro MCP server exposes both widget-adding tools (doc_create,
diagram_create, table_create — add content onto an existing board) and a
board_create_format tool 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, and miro-table skills only pointed
at 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.md frontmatter description field, before any MCP tool description
is ever read, so there was no way to reach the standalone-format tool.

Proposed changes

  • Add a new miro-format skill as the standalone-format counterpart to
    miro-doc/miro-diagram/miro-table, routing to the MCP server's
    standalone format-creation tools (document, table, diagram, timeline,
    kanban, slide deck, prototyping container, activities board, embed).
  • Scope miro-doc, miro-diagram, and miro-table's description
    frontmatter 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.
  • Bump the miro plugin version 1.3.01.4.0 in plugin.json and
    marketplace.json.
  • Propagate the new skill / updated skill count and list through
    README.md, CLAUDE.md, CONTRIBUTING.md, and the docs/ vendor pages
    (docs/claude-code/miro.md, docs/agent-skills/overview.md,
    docs/gemini-cli/overview.md, docs/mcp/tools-reference.md).
  • Regenerate all downstream mirrors (codex-plugins/, cursor-plugins/,
    copilot-cowork-plugins/, skills/, gemini-extension.json) via
    bun run convert from the single source of truth under
    claude-plugins/miro/skills/.

Unrelated changes (optional)

None

Testing / Validation

  • bun run validate passes (plugin.json schema, SKILL.md frontmatter,
    MCP consistency, Codex/Cowork manifest checks).
  • Manually confirmed the generated mirrors under codex-plugins/,
    cursor-plugins/, copilot-cowork-plugins/, skills/, and
    gemini-extension.json are byte-identical to the source under
    claude-plugins/miro/skills/ after bun run convert.

Notes (optional)

None

Dependencies (optional)

None

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
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).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant