---
name: pradeepmouli/skillit-mcp-docs
source: https://app.decimal.ai/s/pradeepmouli-skillit-mcp-docs@1/SKILL.md
source_sha256: c4719ea22f5a
---

# MCP Documentation Conventions

Use this skill when documenting MCP servers for `@skillit/mcp`.

## Focus Areas

- Tool descriptions that explain purpose and invocation scenarios
- Flat `_meta` string fields — `useWhen`, `avoidWhen`, `never`, `remarks`, `example`
- Parameter and schema descriptions that explain valid inputs and effects
- Stable, specific tool names instead of generic verbs

## Fix Patterns

- Add one-sentence tool descriptions with when-to-call guidance
- Set `_meta.useWhen = "[scenario]"` directly on the tool's `_meta` — not nested under a `toSkills` key, and not an array
- Document each schema property with the effect on server behavior
- Prefer names like `read_project_file` over `get`