# 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.

- Skill: `miroapp/skills-development` (Agent Skill)
- Install (CLI): `npx skillmds@latest add miroapp/skills-development`
- Raw SKILL.md: https://api.skillmd.com/api/skills/miroapp/skills-development/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: miroapp (https://skillmd.com/u/miroapp)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/miroapp/skills-development

---


# 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.