CtrlK
BlogDocsLog inGet started
Tessl Logo

improving-mcp-tools

Run an improve-my-MCP campaign: an autoresearch-style loop that measures the MCP agent experience with the eval harness, picks the highest-impact tool problem from production data, makes one bounded fix, and keeps it only if before/after scores improve. Use when asked to "improve my MCP", run an MCP improvement campaign, fix tool discoverability or descriptions based on evidence, or prepare an eval-backed PR for a tool change. Every shipped change must carry eval evidence; guardrails below are hard rules.

80

Quality

100%

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

SKILL.md
Quality
Evals
Security

Quality

Content

100%

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

The body is a dense, well-organized operating manual: lean and free of concept padding, fully actionable with concrete commands and thresholds, a clearly sequenced workflow with explicit validation and feedback loops, and a clean one-level-deep reference split. No dimension shows meaningful weakness.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — terms like 'p50/p95', 'feature-flag gating', and 'autoresearch-style loop' are used without explanation, and every line is operational guidance rather than concept re-explanation, matching the 'lean and efficient; every token earns its place' anchor.

3 / 3

Actionability

It provides copy-paste-ready commands ('LIVE_MCP_URL=... pnpm exec tsx evals/runner/probe.ts --out score.json', 'NODE_ENV=development PORT=9876 ... pnpm dev:hono'), named analytics tools, exact allowlist file paths, and concrete thresholds (≤400 changed lines, stop after 3 open PRs), matching the 'fully executable code/commands; copy-paste ready' anchor.

3 / 3

Workflow Clarity

A clearly sequenced six-step iteration (Measure→Pick→Fix→Validate→Ship→Journal) with an explicit validation checkpoint ('Keep the change only if the target metric improves and nothing else degrades'), a mandatory no-regression sample, and a 'Failure modes to expect' feedback section, matching the 'clear sequence with explicit validation steps; feedback loops' anchor.

3 / 3

Progressive Disclosure

The SKILL.md is a well-sectioned overview that offloads the detailed journal/PR-evidence format to a single clearly signaled, one-level-deep reference (references/campaign-journal.md, verified to exist), matching the 'clear overview with well-signaled one-level-deep references' anchor.

3 / 3

Total

12

/

12

Passed

Description

100%

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: it states several concrete actions, gives an explicit 'Use when…' trigger list of natural phrases, answers both what and when, and occupies a distinct niche with no first/second-person voice. It is concise rather than padded.

DimensionReasoningScore

Specificity

Names multiple concrete actions — 'measures the MCP agent experience with the eval harness', 'picks the highest-impact tool problem from production data', 'makes one bounded fix', and 'keeps it only if before/after scores improve' — matching the 'lists multiple specific concrete actions' anchor rather than the partial level-2 anchor.

3 / 3

Completeness

It answers both 'what' (the autoresearch loop of measure→fix→re-score→keep) and 'when' via an explicit 'Use when…' trigger clause, matching the 'clearly answers both what AND when' anchor; it is not level 2, which would have what with when missing or only implied.

3 / 3

Trigger Term Quality

The explicit 'Use when asked to "improve my MCP", run an MCP improvement campaign, fix tool discoverability or descriptions based on evidence, or prepare an eval-backed PR' clause covers natural phrasings a user would actually say, satisfying the 'good coverage of natural terms' anchor rather than only 'some relevant keywords'.

3 / 3

Distinctiveness Conflict Risk

It carves a clear niche — an eval-evidence-backed MCP tool-improvement campaign — with distinct triggers unlikely to fire for unrelated skills, matching the 'clear niche with distinct triggers' anchor; voice is third person, so no specificity penalty applies.

3 / 3

Total

12

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
PostHog/posthog
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.