Skills Development

Use when authoring or revising plugin SKILL.md files in this repo. Captures the principles for keeping skills as compact shortcuts to MCP tool groups.

miroapp 0fd8fb1 949 B Updated

File contents

Skills Development

Principles for writing SKILL.md files in this repo:

  • Do not duplicate parameter definitions or tool descriptions. Duplication drifts, contradicts the live tools, and steers the agent away from features that work.
  • The agent must fetch parameter definitions and tool descriptions from the MCP server directly at call time.
  • Do not name specific tools, prefixes, or suffixes. The agent finds them in the MCP tool list.
  • Do not name specific parameters either. Describe values in prose ("the board item ID", "the image resource ID") rather than introducing code-shaped names (item_id, board_id). Parameter names drift the same way tool names do, and the agent should read the live MCP schema.

miroapp/miro-ai/tree/main/.agents/skills/skills-development commit 0fd8fb1384

Frequently asked questions

npx skillmds@latest add miroapp/skills-development