mcp-server-instructions
Write effective MCP server instructions for tool compaction support. Use when creating or updating the `instructions` parameter in MaaSProtectedFastMCP server initialization. Helps LLMs understand when to search for tools, workflow patterns, and cross-feature relationships.
npx skills add majiayu000/claude-skill-registry --skill mcp-tool-skill-adawalli-nexus --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# MCP Server Instructions Write workflow-focused server instructions that help LLMs understand your server's capabilities. ## What Instructions Are The `instructions` field is an optional string in MCP's `InitializeResult` that gets injected into the LLM's system prompt. It helps models understand: - How to use your server's tools together - When to search for specific tools (with tool compaction) - Operational constraints and patterns **Evidence**: In controlled testing, well-written instructions improved task success from 60% to 85% - a 25% improvement. ## Template ```python instructions="""[Server name] for [domain] operations. KEY WORKFLOWS: - [Name]: [tool1] -> [tool2] -> [tool3] - [Name]: [tool1] -> [tool2] (when [condition]) CONSTRAINTS: - [Limit or behavior users need to know] - [Input format quirks] - [Auto-pagination or chunking behavior]""" ``` ## What to Include Focus on what individual tool descriptions don't convey: | Include | Example | | ---------------------------- | ----------------------------------------------------- | | **Cross-tool relationships** | "Always call authenticate before any fetch\_\* tools" | | **Operational patterns** | "Search results expire afte
- What Instructions Are
- Template
- What to Include
- What to Avoid
- Process
- Common Patterns
- Examples
- Good
- Bad
- Limitations
What does the mcp-server-instructions skill do?
Write effective MCP server instructions for tool compaction support. Use when creating or updating the `instructions` parameter in MaaSProtectedFastMCP server initialization. Helps LLMs understand when to search for tools, workflow patterns, and cross-feature relationships.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill mcp-tool-skill-adawalli-nexus --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.