agentsclimarketplace

Skillit mcp docs

Skill pradeepmouli/skillit/packages/mcp/skills/skillit-mcp-docs

MCP server documentation conventions for high-quality generated skills. Use when writing tool descriptions, `_meta` annotations, or input schemas for MCP extraction.From its SKILL.md

Install
npx -y skills add pradeepmouli/skillit --skill skillit-mcp-docs

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 7 stars7 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

1.0 KB, 161 tokens by cl100k_base, as published. Nobody here has run it

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

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.