CtrlK
BlogDocsLog inGet started
Tessl Logo

mcp-builder

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

74

2.55x
Quality

62%

Does it follow best practices?

Impact

97%

2.55x

Average score across 3 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/all-skills/skills/mcp-builder/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

89%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a solid description that clearly identifies its niche (MCP server development) and provides explicit 'Use when' guidance with relevant technology names. Its main weakness is that the 'what' portion is somewhat high-level—it could benefit from listing more specific concrete actions like defining tools, configuring transports, or handling authentication. Overall, the strong trigger terms and clear when-clause make it effective for skill selection.

Suggestions

Add more specific concrete actions to the 'what' portion, e.g., 'defining tools and resources, configuring transports, handling authentication, structuring server responses' to improve specificity.

DimensionReasoningScore

Specificity

The description names the domain (MCP servers) and a general action ('creating high-quality MCP servers that enable LLMs to interact with external services through well-designed tools'), but it doesn't list multiple specific concrete actions like defining tools, handling authentication, setting up transport layers, etc.

2 / 3

Completeness

Clearly answers both 'what' (creating high-quality MCP servers that enable LLMs to interact with external services through well-designed tools) and 'when' ('Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK)').

3 / 3

Trigger Term Quality

Includes strong natural keywords users would say: 'MCP', 'Model Context Protocol', 'MCP servers', 'FastMCP', 'MCP SDK', 'external APIs', 'Python', 'Node/TypeScript', 'tools', and 'integrate'. These cover the main variations a user building MCP servers would naturally use.

3 / 3

Distinctiveness Conflict Risk

MCP server development is a very specific niche with distinct trigger terms (MCP, Model Context Protocol, FastMCP, MCP SDK). This is unlikely to conflict with general coding skills or other integration-related skills.

3 / 3

Total

11

/

12

Passed

Implementation

35%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill provides a comprehensive but overly verbose guide to MCP server development. Its main strength is the well-structured four-phase workflow and clear references to language-specific guides. However, it suffers significantly from verbosity — explaining general software engineering concepts Claude already knows — and lacks the concrete, executable code examples that would make it truly actionable. Much of the content reads like a tutorial for a junior developer rather than concise instructions for an AI agent.

Suggestions

Cut sections explaining concepts Claude already knows (what error handling is, DRY principle, async/await patterns, what API documentation contains) — reduce to just MCP-specific guidance and constraints.

Add concrete, executable code examples for at least one complete tool implementation in both Python and TypeScript, rather than deferring all code to reference files.

Move the 'Agent-Centric Design Principles' section (1.1) to a reference file since it's lengthy conceptual content, and replace with a brief bullet list of key principles.

Add explicit validation checkpoints with concrete commands, e.g., a specific test command to verify a tool responds correctly, rather than vague 'ensure quality' instructions.

DimensionReasoningScore

Conciseness

The skill is extremely verbose, with extensive explanations of concepts Claude already knows (what MCP is, what error handling is, what DRY means, what async/await is). Many sections describe general software engineering principles rather than providing MCP-specific actionable content. The document could be reduced by 60%+ without losing meaningful information.

1 / 3

Actionability

The skill provides some concrete guidance (specific URLs to fetch, XML format for evaluations, tool annotation fields) but lacks executable code examples. Most instructions are procedural descriptions ('implement proper error handling', 'use shared utilities') rather than copy-paste ready code or commands. The actual implementation details are deferred to reference files.

2 / 3

Workflow Clarity

The four-phase workflow is clearly sequenced and logically organized. However, validation checkpoints are weak — Phase 3 mentions testing but the validation steps are vague ('verify Python syntax', 'ensure it completes without errors'). The warning about hanging processes is valuable, but there's no explicit feedback loop for fixing issues found during review. The testing guidance lacks concrete validation commands beyond basic syntax checking.

2 / 3

Progressive Disclosure

The skill references multiple external files (python_mcp_server.md, node_mcp_server.md, evaluation.md, mcp_best_practices.md) with clear links and descriptions, which is good structure. However, no bundle files were provided to verify these references exist, and the main SKILL.md itself contains too much inline content that could be in reference files (e.g., the entire agent-centric design principles section, the detailed evaluation requirements). The Reference Files section at the bottom redundantly re-lists everything already mentioned inline.

2 / 3

Total

7

/

12

Passed

Validation

90%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
davepoon/buildwithclaude
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.