CtrlK
BlogDocsLog inGet started
Tessl Logo

mcp-setup

Configure popular MCP servers for enhanced agent capabilities

59

Quality

49%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Risky

Do not use without reviewing

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/mcp-setup/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

22%

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 description is too vague and incomplete to effectively guide skill selection. It lacks specific actions (what configuration steps?), concrete capabilities being enhanced, and critically missing any 'Use when...' guidance. The term 'MCP servers' provides some distinctiveness but the rest is generic filler.

Suggestions

Add a 'Use when...' clause with specific trigger terms like 'MCP setup', 'install MCP server', 'connect to MCP', or names of popular MCP servers

Replace 'enhanced agent capabilities' with specific capabilities like 'file system access, database connections, API integrations'

List concrete configuration actions such as 'install, authenticate, and connect MCP servers including filesystem, GitHub, and Slack integrations'

DimensionReasoningScore

Specificity

The description uses vague language - 'configure' and 'enhanced agent capabilities' are abstract. It doesn't specify what configuration actions are performed (install, setup, modify settings) or what capabilities are enhanced.

1 / 3

Completeness

Only partially addresses 'what' (configure MCP servers) with no specifics, and completely missing 'when' guidance. No 'Use when...' clause or trigger conditions are provided.

1 / 3

Trigger Term Quality

Contains 'MCP servers' which is a relevant technical term users might say, but 'configure' and 'agent capabilities' are generic. Missing natural variations like 'MCP setup', 'server installation', or specific server names.

2 / 3

Distinctiveness Conflict Risk

'MCP servers' provides some specificity that distinguishes it from general configuration skills, but 'configure' and 'agent capabilities' are broad enough to potentially overlap with other setup or configuration skills.

2 / 3

Total

6

/

12

Passed

Implementation

77%

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

This is a solid, actionable skill for MCP server configuration with clear executable commands and good workflow structure. The main weakness is some verbosity in the completion message and inline troubleshooting that could be more concise or split into separate reference files. The skill effectively guides through the configuration process with verification steps.

Suggestions

Trim the completion message template - Claude can generate appropriate success messages without a verbose template

Consider moving the Common Issues section to a separate TROUBLESHOOTING.md file and linking to it

DimensionReasoningScore

Conciseness

The skill is reasonably efficient but includes some unnecessary verbosity in the completion message section and could be tightened. The step-by-step structure adds some overhead, though most content is actionable.

2 / 3

Actionability

Provides fully executable bash commands for each MCP server configuration, with specific examples for different scenarios (Docker vs HTTP, with/without env vars). Commands are copy-paste ready.

3 / 3

Workflow Clarity

Clear 5-step sequence with explicit verification step (Step 4: `claude mcp list`). Includes troubleshooting section for error recovery and clear next steps. The workflow is well-structured for a configuration task.

3 / 3

Progressive Disclosure

Content is well-organized with clear sections, but everything is inline in a single file. The troubleshooting and common issues sections could potentially be split out, and the completion message template is quite long.

2 / 3

Total

10

/

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
Yeachan-Heo/oh-my-claudecode
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.