Skip to content
Agentmart
Submit a tool

skillit-mcp-docs

MCP server documentation conventions for high-quality generated skills.

Skill by pradeepmouli

IndexedMIT★ 7
Write a review

Install

Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install skill/pradeepmouli-skillit-mcp-docs

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

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

Use cases: backend, writing, agent-building

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.

Tools
No tools found
Secrets
None asked for
Install scripts
None found

Network hosts it talks to 1

  • codeload.github.com · found in install command

Files it touches

  • ~/.claude/skills/skillit-mcp-docs

What's inside

Skill name
skillit-mcp-docs
Description
MCP server documentation conventions for high-quality generated skills. Use when writing tool descriptions, `_meta` annotations, or input schemas for MCP extraction.
License
MIT
Instructions
19 lines in SKILL.md · view on GitHub

Files (1)

  • SKILL.md

SKILL.md (first lines)

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

From pradeepmouli/skillit, MIT.

More from pradeepmouli/skillit

Signals

Stars
7
Forks
2
Open issues
0
Last commit (this folder)
Jul 2, 2026 (3 months ago)
Last release
Sep 21, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026).

Details

License
MIT
First seen
Oct 24, 2026
Last checked
Oct 24, 2026

More from pradeepmouli

Cite this page

skillit-mcp-docs. Agent Mart. https://agentmart.dev/skills/pradeepmouli-skillit-mcp-docs (last updated 2026-10-24)