CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

mcp-builder

Create MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. The quality of an MCP server is measured by how well it enables LLMs to accomplish real-world tasks.

Quality

65%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/mcp-builder/SKILL.md

The canonical home for this skill is mcp-builder in administrakt0r/AI-Agents-Safe-Coding-Skills

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.

A well-organized, well-sequenced process guide with concrete commands and a thoughtful evaluation phase, undermined by a critical bundle defect: all four referenced guide files are missing (the paths point to a nonexistent ./reference/ directory), so the detailed implementation content the body repeatedly defers to is unreachable. Minor issues include duplicated reference listings and a vacuous 'When to Use' section.

Suggestions

Fix the reference layer: either add the four missing files under the path used in the body, or correct all links to the actual bundle layout and directly reference scripts/evaluation.py, scripts/connections.py, and scripts/example_evaluation.xml where evaluations are discussed.

Remove duplication: collapse the Phase 1.3 and 'Reference Files' documentation listings into one library section, drop the verbatim description repeat in the Overview, and delete or rewrite the empty 'When to Use' section.

Add an explicit error-recovery loop in Phase 3/4 (e.g. 'if the build fails or an evaluation answer cannot be verified, fix and re-run') and give the Annotations flags one line of actual guidance instead of a bare true/false list.

DimensionReasoningScore

Conciseness

The four-phase structure is largely efficient, but there is real duplication and filler: the Overview repeats the frontmatter description verbatim, the entire documentation library is listed twice (in Phase 1.3 and again in the 'Reference Files' section), the 'When to Use' section says nothing ('This skill is applicable to execute the workflow or actions described in the overview'), and the Annotations section merely lists four flag names with true/false. This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened'); it is above anchor 2 because most sections carry real, non-obvious guidance, and below anchor 4 because the duplication and filler are noticeable.

3 / 5

Actionability

There is genuinely concrete material — exact URLs and the '.md suffix' fetch trick for the MCP spec, SDK README URLs, build/test commands ('npm run build', 'npx @modelcontextprotocol/inspector', 'python -m py_compile'), specific library guidance (Zod/Pydantic, outputSchema, structuredContent), and a copy-paste XML output example. However, all actual implementation detail (working server code, project structure, tool registration patterns) is deferred to the four reference guides, and none of those files exist in the bundle, so the key executable details are unreachable. This lands at anchor 3 ('some concrete guidance but incomplete... missing key details') rather than anchor 4's 'minor gaps'.

3 / 5

Workflow Clarity

The four phases (research → implement → review/test → evaluate) are clearly sequenced, and validation checkpoints are present: build verification, MCP Inspector testing, a code-quality review checklist in Phase 3, and 'Answer Verification: Solve each question yourself to verify answers' in Phase 4. This matches anchor 4 ('clear sequence with most checkpoints present; minor validation gaps'); it falls short of anchor 5 because there is no explicit error-recovery loop (e.g. what to do when the build or an evaluation answer fails), but exceeds anchor 3 because checkpoints are explicit, not merely implied.

4 / 5

Progressive Disclosure

The nominal structure is good — one-level-deep references with load timing ('Load During Phase 2') and clear labels — but every referenced path is broken: './reference/mcp_best_practices.md', './reference/node_mcp_server.md', './reference/python_mcp_server.md', and './reference/evaluation.md' do not exist in the bundle (no references/ directory at all), while the actual bundle files (scripts/evaluation.py, scripts/connections.py, scripts/example_evaluation.xml) are never linked by path. Scored against the actual bundle structure per the judging guidelines, navigation to all detailed content fails, which lands at anchor 2; it does not merit 3 because the problem is not organization but a wholly non-functional reference layer, though the clearly signaled structure keeps it above anchor 1.

2 / 5

Total

12

/

20

Passed

Description

65%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 clear, honest description of a distinct niche with good core vocabulary, but it is missing any 'when to use' trigger guidance and only lists a single concrete capability, with a filler philosophy sentence padding it out. Adding a 'Use when...' clause and one or two more concrete actions would raise it substantially.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks to build, extend, or test an MCP server, or mentions Model Context Protocol, MCP tools, or integrating an external service with Claude.'

Replace the philosophy sentence ('The quality of an MCP server is measured by...') with concrete capabilities such as designing tools with schemas and annotations, choosing transports, and creating evaluations.

Include natural synonyms users would say (e.g. 'build an MCP server', 'MCP server development', 'FastMCP', 'MCP SDK') to improve trigger coverage.

DimensionReasoningScore

Specificity

The description names the domain and one concrete action — 'Create MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools' — but the second sentence ('The quality of an MCP server is measured by how well it enables LLMs to accomplish real-world tasks') is design philosophy, not a capability, so coverage is not comprehensive. This matches anchor 3 (domain + 1-2 concrete actions); it is below anchor 4 because no further specific actions (tool design, testing, evaluation, transport setup) are listed, and above anchor 2 because the action given is concrete rather than generic.

3 / 5

Completeness

The 'what' is clear ('Create MCP servers that enable LLMs to interact with external services through well-designed tools'), but there is no 'Use when...' clause or equivalent trigger guidance anywhere — per the judging guidelines this caps completeness at 3. It fits anchor 3 exactly: clear what, when missing; not anchor 4 because the when is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Natural terms a user would say are present: 'MCP', 'Model Context Protocol', 'servers', 'LLMs', 'tools', 'external services'. This gives good keyword coverage of the domain's primary vocabulary; it is below anchor 5 because common variations like 'MCP server development', 'build an MCP server', or SDK names are absent, and above anchor 3 because both the acronym and the spelled-out protocol name are included.

4 / 5

Distinctiveness Conflict Risk

'Create MCP (Model Context Protocol) servers' carves out a clear niche with a distinct, specific trigger term ('MCP', 'Model Context Protocol') that few other skills would claim, matching anchor 5's 'clear niche with distinct triggers; minimal conflict risk'. It is above anchor 4 because overlap risk with generic server/API-building skills is minimal given the protocol-specific framing.

5 / 5

Total

15

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 10 missing

Warning

Total

14

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/mcp-builder/SKILL.md

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.