CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

mcporter

Discover and call MCP Server tools via the mcporter CLI. Use when your coordinator notifies you about new MCP tools, or when you need to call external APIs. Includes workflow for generating skill documentation for new MCP servers.

Quality

80%

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 ./manager/agent/worker-agent/skills/mcporter/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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 is a strong, execution-focused reference: fully executable mcporter commands, a clearly sequenced coordinator-notification workflow with verify/confirm checkpoints, and well-organized single-level structure with no wasted explanation of concepts Claude already knows. The only refinement opportunities are the inlined example template and the absence of failure-recovery feedback in the workflow.

DimensionReasoningScore

Conciseness

The body is lean — commands are shown once with inline comments, and the Important Notes are one line each. The ~25-line embedded example SKILL.md template (weather-operations) is the one section that could be trimmed or moved, so it does not fully reach the "every token earns its place" anchor; it clearly exceeds the "mostly efficient with some unnecessary explanation" anchor.

4 / 5

Actionability

All guidance is copy-paste ready: exact mcporter commands for both key=value and --args JSON syntax, `agentteams-sync`, `mkdir -p ~/skills/<server-short-name>-operations`, and a complete generated-SKILL.md template with a concrete example call (`mcporter call mcp-weather.get_weather city=Tokyo units=metric`) and parameter table. Specific examples cover the common cases, matching the 5 anchor.

5 / 5

Workflow Clarity

The notification workflow is a clear 4-step sequence (pull config → discover → generate skill → confirm) with a verify checkpoint in Step 2 ("Verify the new server appears") and a confirm checklist in Step 4. It falls short of the 5 anchor because there is no feedback loop for failure cases (e.g., what to do if the server does not appear after agentteams-sync), though the 403 guidance in Important Notes partially compensates.

4 / 5

Progressive Disclosure

No bundle files (references/scripts/assets) exist, and none are needed — the body is ~105 lines of well-sectioned content with no nested references and clear section headers (Commands, notification workflow, Important Notes). It exceeds the simple-skill exception's 50-line threshold, and the inlined example template is content that could arguably live in a separate reference file, so it fits the 4 anchor (good structure, most content appropriately placed) rather than 5.

4 / 5

Total

17

/

20

Passed

Description

67%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.

The description answers what and when explicitly and names concrete capabilities, but uses second-person voice (a scored penalty) and misses natural trigger-term variations like "Model Context Protocol". It sits solidly above the midpoint: clear and actionable, just short of the comprehensive 5-anchor examples.

Suggestions

Rewrite in third person to avoid the specificity penalty, e.g., "Discovers and calls MCP Server tools via the mcporter CLI. Use when a coordinator notifies about new MCP tools, when Model Context Protocol (MCP) tool calls are needed, or when calling external APIs."

Add natural trigger synonyms and variations users would actually say: "Model Context Protocol", "tool call", "invoke an MCP tool", "add a new MCP server".

Tighten the overly broad "when you need to call external APIs" trigger to something more specific to MCP tooling (e.g., "when a task requires calling an MCP Server tool") to reduce overlap with generic API-request skills.

DimensionReasoningScore

Specificity

"Discover and call MCP Server tools via the mcporter CLI" and "Includes workflow for generating skill documentation for new MCP servers" list several concrete actions with minor gaps (no mention of listing/inspecting tool schemas). Per the guideline penalizing second-person voice, "Use when your coordinator notifies you" ("you", "your") reduces the anchor-level 5 by 1.

4 / 5

Completeness

Both parts are explicit: the what is "Discover and call MCP Server tools via the mcporter CLI" and the when is "Use when your coordinator notifies you about new MCP tools, or when you need to call external APIs". The when is present but the second trigger ("call external APIs") is somewhat broad and could be more specific, matching the 4 anchor rather than the fully concrete 5 anchor.

4 / 5

Trigger Term Quality

Relevant keywords are present ("new MCP tools", "call external APIs", "MCP Server") but common variations a user would naturally say are missing — no "Model Context Protocol", "tool call", or file/command synonyms. This matches "Some relevant keywords but missing common variations or synonyms" rather than 4, which requires only a few missing natural terms.

3 / 5

Distinctiveness Conflict Risk

The mcporter CLI and coordinator-notification workflow give it a clear niche, but "when you need to call external APIs" overlaps with generic API-calling skills — minor overlap risk with closely related skills, matching the 4 anchor; not the minimal-conflict 5 anchor.

4 / 5

Total

15

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

agentscope-ai/AgentTeams

Path

manager/agent/worker-agent/skills/mcporter/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.