Skip to content
cccskills
FreePublished on GitHub

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.

The English summary is being prepared. Showing the original description.

pradeepmouli/skillit
See how to install

Files included (1)

  • SKILL.md985 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

skillit

Free

Generate structured AI agent skills (SKILL.md) and llms.txt from your TypeScript API documentation

The English summary is being prepared. Showing the original description.

pradeepmouli/skillit7Updated Oct 19, 2026

skillit-bootstrap

Free

Bootstrap an AI-agent skill from a TypeScript codebase by running the deterministic skillit generate/audit loop and enriching repo source (JSDoc, README, config-type properties, MCP tool annotations, examples, package.json) until the skill reaches its grade target. Use for cli, typedoc, config, or mcp (build-mode) projects; never edit SKILL.md/references directly.

The English summary is being prepared. Showing the original description.

pradeepmouli/skillit7Updated Oct 19, 2026

skillit-cli

Free

Extract CLI command structure from commander/yargs for AI agent skill generation Use when working with agent-skills, cli, commander, documentation, skill-generation, yargs.

The English summary is being prepared. Showing the original description.

pradeepmouli/skillit7Updated Oct 19, 2026

skillit-cli-docs

Free

CLI documentation conventions for generated skills. Use when improving Commander descriptions, help text, positional argument docs, and config-surface correlation.

The English summary is being prepared. Showing the original description.

pradeepmouli/skillit7Updated Oct 19, 2026

skillit-core

Free

Shared types, SKILL.md renderer, and token budgeting for skillit plugins

The English summary is being prepared. Showing the original description.

pradeepmouli/skillit7Updated Oct 19, 2026

skillit-docs

Free

Generate AI agent skills from TypeScript documentation

The English summary is being prepared. Showing the original description.

pradeepmouli/skillit7Updated Oct 19, 2026

See all skills by pradeepmouli

Report a problem with this skill