mcpField
S
skills-development

skills-development

github.com/miroappAgent workflows164121 installsUpdated 6w ago
Repository

About skills-development

skills-development is a set of principles for writing SKILL.md files in this repository. It keeps tool and parameter details sourced from the live MCP server so skill instructions do not duplicate definitions that can drift.

Key features

  1. 01Avoids duplicating tool descriptions
  2. 02Fetches live tool schemas at call time
  3. 03Keeps tool and parameter names out of prose

Use cases

  1. 01Writing or revising repository skill files
  2. 02Keeping skill guidance aligned with live MCP tools

MCP support

It instructs agents to retrieve tool descriptions and parameter definitions directly from the MCP server when needed.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/miroapp/miro-ai --skill skills-development

After installing, type/skills-developmentin Claude Code to confirm it loaded.

Details

From the project README

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.

Comments

Markdown supported