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).

91

2.21x
Quality

67%

Does it follow best practices?

Impact

93%

2.21x

Average score across 10 eval scenarios

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./resources/skills/mcp-builder/SKILL.md

The canonical home for this skill is pleaseai/mcp-dev

SKILL.md
Quality
Evals
Security

Quality

Content

52%Weight 40%Scale 1-5

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

The skill body presents a well-sequenced four-phase workflow with useful concrete commands, but it is held back by a broken progressive-disclosure layer: all five reference-file links point to a nonexistent directory, leaving the body's heavy deferral of implementation detail unbacked. Inline actionability and conciseness are middling because implementation guidance stays high-level while the closing section duplicates links already given inline.

Suggestions

Fix the broken references: either include the ./reference/ files (mcp_best_practices.md, node_mcp_server.md, python_mcp_server.md, evaluation.md) in the bundle or correct the paths — currently every detailed guide the body defers to is missing.

Link the bundled scripts directly (scripts/evaluation.py, scripts/connections.py, scripts/example_evaluation.xml) instead of reaching them only through the missing evaluation guide, and show the invocation command inline.

Consolidate the duplicate reference listings: the closing 'Reference Files' section repeats the links, SDK URLs, and descriptions already given in Phases 1 and 2 — keep one canonical, phase-tagged list.

DimensionReasoningScore

Conciseness

The body is mostly efficient (terse bullet checklists like "readOnlyHint: true/false", and it delegates detail to reference files), but the entire closing "Reference Files" section re-lists links and SDK URLs already given verbatim in Phase 1, and "4.1 Understand Evaluation Purpose" restates what the skill already says. It fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than 4, where only minor trimming would be needed.

3 / 5

Actionability

There is real concrete guidance (specific commands like `npx @modelcontextprotocol/inspector`, `python -m py_compile your_server.py`, WebFetch URLs, and a complete XML example), but the core implementation guidance is high-level checklists ("Create shared utilities: API client with authentication", "Use Zod (TypeScript) or Pydantic (Python)") with no executable code in the body — the code is entirely deferred to reference files. This sits between 'minimal concrete guidance' (2) and 'mostly executable guidance' (4).

3 / 5

Workflow Clarity

Four phases are clearly sequenced (research → implement → review/test → evaluations) with explicit build/test commands and a verification step ("Solve each question yourself to verify answers", MCP Inspector testing). It is not 5 because there is no explicit error-recovery feedback loop for build/test failures (e.g., what to do when compilation fails), only 'verify' steps.

4 / 5

Progressive Disclosure

The in-text structure is well designed (one-level references, phase-organized, 'load as needed' signals), but scored against the actual bundle every reference link (./reference/mcp_best_practices.md, node_mcp_server.md, python_mcp_server.md, evaluation.md) points to files that do not exist — no reference/ directory is present — and the bundled scripts/ files (evaluation.py, connections.py, example_evaluation.xml) are never directly linked. Navigation to the detailed materials is broken in practice, which is worse than 'minor organization gaps' (4) and closer to 'references are buried'/structure fails (2).

2 / 5

Total

12

/

20

Passed

Description

82%Weight 40%Scale 1-5

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

A strong description with an explicit 'Use when' trigger clause, good natural keyword coverage, and a clearly distinctive niche. Its only weakness is specificity — it states one broad capability rather than enumerating the concrete actions the skill covers.

Suggestions

Enumerate 2-3 concrete capabilities in the description (e.g., 'define tools with Zod/Pydantic schemas, implement authentication and pagination, create XML evaluation suites') to raise specificity.

Add a few natural trigger synonyms such as 'MCP integrations' or 'expose an API to Claude as tools' to broaden trigger coverage.

DimensionReasoningScore

Specificity

The description names the domain ("creating high-quality MCP... servers") and one concrete capability ("enable LLMs to interact with external services through well-designed tools"), but does not enumerate several specific actions, matching the 'names domain and 1-2 concrete actions' anchor. It is not a 4 because there is no list of specific actions with only minor gaps (e.g., tool definition, auth handling, testing, evaluations are never mentioned).

3 / 5

Completeness

It clearly answers both questions: the 'what' ("Guide for creating high-quality MCP... servers that enable LLMs to interact with external services through well-designed tools") and an explicit 'when' with concrete triggers ("Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript"). This matches the top anchor exactly.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "MCP", "Model Context Protocol", "MCP servers", "Python (FastMCP)", "Node/TypeScript", "MCP SDK", "external APIs or services" — phrases a user would naturally say. It is not a 5 because common synonyms and variations such as "MCP integrations", "MCP tools", or "expose an API as a tool" are missing.

4 / 5

Distinctiveness Conflict Risk

"MCP server" construction is a clear niche with distinct trigger terms; no other common skill would claim these triggers, so conflict risk is minimal. The MCP qualifier keeps "integrate external APIs or services" from overlapping with generic API-integration skills.

5 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 10 missing

Warning

Total

15

/

16

Passed

Repository
ThinkInAIXYZ/deepchat
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.