skillit-mcp-docs

MCP tool descriptions should be concise and explicitly state the tool's purpose and when to call it. This guidance ensures the generated skills accurately reflect valid inputs and behavior for stable agent discovery.

MCP server documentation should use flat _meta fields like useWhen, avoidWhen, never, remarks, and example. These annotations provide invocation guidance that improves downstream skill generation and tool discovery.

Generated skills often mismatch inputs when MCP server documentation lacks property-level schema explanations. Adding detailed input schema documentation for each property ensures generated skills correctly reflect valid inputs and expected behavior.

The best way to document input schemas for MCP skills is to provide property-level explanations for every field. This ensures stable discovery by helping agents understand valid inputs before invoking the tool.

Yes, property-level schema details are required for high-quality skill generation. Documenting each input schema property ensures that extracted skills accurately represent the valid inputs and behavior expected by the MCP server.