mcp-tool-docs-stinger — Claude Code skill: honest tool documentation
mcp-tool-docs-stinger — a skill for documenting MCP tools, TypeScript APIs, and CLIs grounded in source code: schemas, outputs, side effects, examples. Use when writing or auditing tool, API, or CLI documentation.
AGPL-3.0-or-later ★ 96 updated 2026-10-18
/plugin marketplace add legioncodeinc/vibe-coding-tools
/plugin install documentation-tools@wasp-nestWhat mcp-tool-docs-stinger does
mcp-tool-docs-stinger teaches how to document MCP tool schemas honestly—straight from the tool registration and handler code. It covers how to describe inputs and outputs, side effects, annotations, and usage examples. The skill also addresses TypeScript API references (using TypeDoc or API Extractor), CLI command surfaces, and keeping documentation in sync with code to prevent drift.
The skill includes step-by-step guides in guides/ (documentation principles, how-to for each surface type, a 10-point validation checklist), templates in templates/, and worked examples based on Hivemind—an MCP server with a TypeScript API and CLI. Start by reading guides/00-principles.md, then guides/01-mcp-tool-docs.md, then proceed by task.
For Claude Code, install via the plugin marketplace. Codex, Cursor, and other platforms have alternative installation methods.
What it helps with
- Write input and output schemas for an MCP tool that stays true to the code
- Generate a TypeScript API reference from source
- Document CLI commands, flags, and their side effects
- Find where documentation has drifted from the code
- Write a changelog entry tied to a released version
Example prompts for the agent
- Document these MCP tools with honest schema and output descriptions
- Is this tool description accurate? Does it match what the code does?
- Resync the documentation—it's out of step with the code
How to install mcp-tool-docs-stinger
1Plugin marketplace
/plugin marketplace add legioncodeinc/vibe-coding-tools/plugin install documentation-tools@wasp-nestThis installs the whole documentation-tools plugin with all its skills
2Skills CLI (Vercel)
npx skills add legioncodeinc/vibe-coding-tools --skill mcp-tool-docs-stinger -a claude-code3Manually: put the files in place
~/.claude/skills/mcp-tool-docs-stinger/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/mcp-tool-docs-stinger/
1Skills CLI (Vercel)
npx skills add legioncodeinc/vibe-coding-tools --skill mcp-tool-docs-stinger -a codex2Manually: put the files in place
.agents/skills/mcp-tool-docs-stinger/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add legioncodeinc/vibe-coding-tools --skill mcp-tool-docs-stinger -a cursor2Manually: put the files in place
.cursor/skills/mcp-tool-docs-stinger/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install legioncodeinc/vibe-coding-tools plugins/documentation-tools/skills/mcp-tool-docs-stinger2Manually: put the files in place
.github/skills/mcp-tool-docs-stinger/SKILL.md1Skills CLI (Vercel)
npx skills add legioncodeinc/vibe-coding-tools --skill mcp-tool-docs-stinger -a gemini-cli2Platform CLI
gemini skills install https://github.com/legioncodeinc/vibe-coding-tools --path plugins/documentation-tools/skills/mcp-tool-docs-stingerManually: put the files in place
.devin/skills/mcp-tool-docs-stinger/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about mcp-tool-docs-stinger
How do I install mcp-tool-docs-stinger in Claude Code?
Run /plugin marketplace add legioncodeinc/vibe-coding-tools, then /plugin install documentation-tools@wasp-nest, then npx skills add legioncodeinc/vibe-coding-tools --skill mcp-tool-docs-stinger -a claude-code and open ~/.claude/skills/mcp-tool-docs-stinger/SKILL.md.
What does mcp-tool-docs-stinger do?
It teaches how to document MCP tools, TypeScript APIs, and CLI commands while keeping them in sync with source. It provides guides, templates, and worked examples for each documentation type.
Can I install mcp-tool-docs-stinger in IDEs other than Claude Code?
Yes. For Codex: npx skills add legioncodeinc/vibe-coding-tools --skill mcp-tool-docs-stinger -a codex. Installation methods exist for Cursor, GitHub Copilot, Gemini CLI, and Windsurf, but primary support is Claude Code and Codex.