CtrlK
BlogDocsLog inGet started
Tessl Logo

using-mcp-tools

Reference for the `letta mcp` CLI, which finds and invokes MCP tools available to this agent. A system reminder already lists your connected MCP servers and the basic search/schema/call commands; invoke this skill when you need more — browsing a server's tools, passing large or file-based arguments, tuning search, or troubleshooting missing servers, tools, and errors.

70

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

An efficient, fully executable CLI reference with clear section structure and built-in error-recovery guidance. It assumes Claude's competence and adds only non-obvious operational detail, scoring at the top of most dimensions.

DimensionReasoningScore

Conciseness

Lean throughout: it never explains what MCP/JSON are, uses compact commented command blocks, and each prose line (e.g. "Rank order is meaningful; absolute scores are not comparable across queries") earns its place with non-obvious guidance. Matches the lean-and-efficient anchor.

5 / 5

Actionability

Fully executable command block (letta mcp list/get/tools/schema/search/call) with flag defaults, argument forms, and exit codes all specified — copy-paste ready and covering the common cases, matching the score-5 anchor.

5 / 5

Workflow Clarity

The implicit find-tool (list/tools/search) → schema → call sequence is clear, and the call/troubleshooting sections give error-recovery loops (exit code 2 → read content, fix args, retry; auth error → re-authenticate). Not a 5 because the sequence is implied rather than an explicit numbered workflow with checkpoints.

4 / 5

Progressive Disclosure

Under 50 lines with no bundle files and no need for external references; content is organized into well-signaled sections (Commands, Search options, Call arguments and results, Troubleshooting), satisfying the simple-skill exception for a score of 5.

5 / 5

Total

19

/

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, specific description that clearly states both capability and trigger conditions, anchored to a distinct CLI niche. Its main weakness is the second-person/imperative voice ("invoke this skill when you need more"), which the rubric penalizes.

Suggestions

Rewrite in third person to avoid the voice penalty, e.g. "Reference for the `letta mcp` CLI... Invoke when the agent needs more than the system reminder provides — browsing a server's tools, passing large or file-based arguments, tuning search, or troubleshooting missing servers, tools, and errors."

Surface a few more natural user phrasings (e.g. "find an MCP tool", "MCP server not working") to lift trigger-term coverage from good to comprehensive.

DimensionReasoningScore

Specificity

Lists several concrete capabilities ("finds and invokes MCP tools", "browsing a server's tools, passing large or file-based arguments, tuning search, or troubleshooting"), which would anchor at 4, but the imperative/second-person phrasing ("invoke this skill when you need more") violates the third-person-voice rule and reduces the score by 1.

3 / 5

Completeness

Explicitly answers both what ("Reference for the `letta mcp` CLI, which finds and invokes MCP tools") and when ("invoke this skill when you need more — browsing... troubleshooting..."), with concrete trigger phrases matching the score-5 anchor.

5 / 5

Trigger Term Quality

Covers natural terms users would say ("MCP tools", "troubleshooting missing servers, tools, and errors", "browsing a server's tools") with good coverage, though a few common phrasings like "find a tool" or "MCP server" as standalone triggers are not as prominent.

4 / 5

Distinctiveness Conflict Risk

Tied to a specific niche (`letta mcp` CLI, "when you need more" beyond the system reminder), making it mostly distinct with only minor overlap risk against a generic MCP-usage skill.

4 / 5

Total

16

/

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
letta-ai/letta-code
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.