---
name: skills-development
description: 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.
---

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