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

56

Quality

65%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/mcp-builder/SKILL.md
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 has a well-sequenced four-phase workflow with some genuinely concrete commands, but its progressive disclosure is fundamentally broken: all four referenced guide files are missing from the bundle and the existing scripts/ files are never surfaced. Combined with a duplicated reference section and no inline code examples, the body reads as a good outline whose supporting materials were never shipped.

Suggestions

Fix the reference layout: the four files cited as ./reference/*.md (mcp_best_practices.md, node_mcp_server.md, python_mcp_server.md, evaluation.md) do not exist in the bundle — either add them under a real references/ directory or correct the paths so the links resolve.

Surface the actual bundle scripts from SKILL.md: scripts/evaluation.py, scripts/connections.py, and scripts/example_evaluation.xml are never referenced; link them in Phase 4 (e.g., "Run scripts/evaluation.py scripts/example_evaluation.xml") so users can execute the evaluation step.

Trim the closing "Reference Files / Documentation Library" section, which duplicates SDK URLs and guide links already listed in Phase 1, and add one small inline code example in Phase 2 (e.g., a Zod or Pydantic tool schema) so implementation guidance is executable without the missing reference files.

DimensionReasoningScore

Conciseness

The body is mostly lean bullets, but the closing "Reference Files / Documentation Library" section (~45 lines) repeats the SDK URLs and guide links already given in Phase 1, and lines like "The quality of an MCP server is measured by how well it enables LLMs to accomplish real-world tasks" add little. This fits the level-3 anchor (mostly efficient but could be tightened) rather than level 4, where only minor trimming would be needed.

3 / 5

Actionability

There are some concrete, executable items (sitemap URL with the `.md` suffix trick, specific WebFetch URLs, `npx @modelcontextprotocol/inspector`, `python -m py_compile`), but much of the implementation guidance is high-level direction ("Create shared utilities: API client with authentication...") with zero code examples, and the detailed guidance is deferred to reference files that are not present in the bundle. That places it at level 3 — some concrete guidance but incomplete — rather than level 4's mostly-executable bar.

3 / 5

Workflow Clarity

The four phases (Research → Implementation → Review/Test → Evaluations) are clearly numbered and sequenced, and Phase 3 provides build/test checkpoints (`npm run build`, MCP Inspector, py_compile) before evaluations begin. It falls short of level 5 because validation details are deferred to missing reference files and Phase 4's verification loop is only sketched ("Solve each question yourself to verify answers"), leaving minor checkpoint gaps.

4 / 5

Progressive Disclosure

The in-body organization and signaling is good (guides labeled "Load First" / "Load During Phase 2"), but every referenced path — ./reference/mcp_best_practices.md, node_mcp_server.md, python_mcp_server.md, evaluation.md — does not exist in the bundle (no reference/ directory), and the actual bundle files in scripts/ (evaluation.py, connections.py, example_evaluation.xml) are never linked from SKILL.md. Scored against the real bundle structure per the rubric guideline, the disclosure structure is broken in practice, matching level 2 rather than level 3, where references are present but merely unclear.

2 / 5

Total

12

/

20

Passed

Description

78%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 keywords including framework names, and a clear what/when pair. Its main weakness is modest action specificity — it says the skill creates MCP servers and integrates APIs but does not enumerate the fuller range of capabilities (tool design, testing, evaluation) the skill covers.

DimensionReasoningScore

Specificity

The description names the domain ("creating high-quality MCP servers") and a concrete action ("enable LLMs to interact with external services through well-designed tools" / "integrate external APIs or services"), but stops at 1-2 actions without covering design, testing, or evaluation work the skill actually guides. It is not the level-4 anchor because it does not list several distinct specific actions, and not level 2 since the actions given are concrete rather than generic.

3 / 5

Completeness

It explicitly answers both: what ("Guide for 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"), with concrete trigger phrases. It clearly fits the level-5 anchor rather than level 4, whose 'when' clause is less specific.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "MCP servers", "Model Context Protocol", "external APIs", "Python (FastMCP)", "Node/TypeScript", "MCP SDK" — terms a user building a server would actually say. Not level 5 because common variations like "build MCP tools", "FastMCP server", or "Claude connector" phrasings are missing.

4 / 5

Distinctiveness Conflict Risk

"MCP servers" / "Model Context Protocol" is a clear, distinct niche with framework-specific triggers (FastMCP, MCP SDK). Minor overlap risk remains with generic API-integration or server-building skills via the phrase "integrate external APIs or services", keeping it just below the level-5 minimal-conflict anchor.

4 / 5

Total

16

/

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
openstatusHQ/data-table-filters
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.