CtrlK
BlogDocsLog inGet started
Tessl Logo

deploying-vmcp-locally

Deploys a VirtualMCPServer configuration locally for manual testing and verification

62

Quality

78%

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 ./.claude/skills/deploying-vmcp-locally/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

This is a strong, runbook-style skill: fully executable commands, a clearly sequenced workflow with explicit verification steps, and a troubleshooting section that closes the feedback loop on real failure modes. The only notable gaps are minor conciseness trims and the absence of any progressive disclosure — everything is inlined in a single ~160-line file rather than splitting examples and auth snippets into reference files.

DimensionReasoningScore

Conciseness

The body is command-driven with minimal padding — sections like "### 4. Verify deployment" and "### 6. Test MCP protocol" give short annotated commands and full curl JSON payloads without explaining Kubernetes or MCP basics. It is not a 5 because of minor trimmable content: the opening line restates the frontmatter description, and the prerequisites list links installation docs Claude could find trivially. It is well above anchor 3, which requires noticeable unnecessary explanation.

4 / 5

Actionability

Every step is copy-paste executable: "task kind-with-toolhive-operator", "kubectl apply -f <path-to-vmcp-yaml> --kubeconfig kconfig.yaml", jsonpath NodePort extraction, and complete curl initialize/tools-list requests with full JSON-RPC bodies. Placeholders like <name> and <path-to-vmcp-yaml> are appropriate parameterization, and the common cases (NodePort vs ClusterIP, discovered vs local-changes workflow) are each covered — matching anchor 5.

5 / 5

Workflow Clarity

Seven clearly sequenced steps run from cluster setup through apply, explicit verification ("### 4. Verify deployment" with status checks and operator logs), endpoint and MCP protocol testing, to cleanup. A dedicated Troubleshooting section gives error-recovery loops for the actual failure modes (stuck Pending, backends not discovered, auth issues), matching anchor 5's "explicit validation steps; feedback loops for error recovery". It is not anchor 4 because validation checkpoints are explicit rather than minor-gapped.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so the skill is a single well-organized file with clear section headers and a cleanly signaled table of example configurations in "examples/operator/virtual-mcps/". Structure is good and navigation is easy (anchor 4), but at ~160 lines with everything inline — including the example YAML table and anonymous-auth snippet that could live in reference files — it is not the anchor-5 ideal of a concise overview with well-signaled one-level-deep references.

4 / 5

Total

18

/

20

Passed

Description

57%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 is clear and unambiguous about its niche but terse: it states a single what-only sentence with no explicit "when to use" guidance and few natural trigger phrases beyond the VirtualMCPServer term itself. Adding a Use-when clause and a few synonyms (vMCP, Kind cluster, local testing) would lift completeness and trigger-term quality.

Suggestions

Add an explicit trigger clause, e.g. "Use when testing or debugging VirtualMCPServer (vMCP) configurations in a local Kind cluster, or when the user mentions vMCP deployment, tool aggregation, or local MCP testing."

Enumerate the concrete capabilities covered (cluster setup, applying the CRD, endpoint/MCP protocol testing, troubleshooting, cleanup) so the description reflects the skill's actual scope.

Include natural synonyms such as "vMCP", "local cluster", and "MCP tool aggregation" so users' phrasings match the description without exact terminology.

DimensionReasoningScore

Specificity

"Deploys a VirtualMCPServer configuration locally for manual testing and verification" names the domain and a compact action set (deploy, test, verify), but stops there — no mention of the Kind cluster setup, kubectl application, endpoint/protocol testing, or cleanup that the skill actually covers. This matches anchor 3 ("Names domain and 1-2 concrete actions, but not comprehensive"); it is below anchor 4 because it does not list several specific actions, and above anchor 2 because the actions are concrete rather than generic.

3 / 5

Completeness

The "what" is clearly stated (deploys a VirtualMCPServer configuration locally for manual testing), but there is no "Use when..." clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is not anchor 4 because the "when" is entirely absent rather than merely imprecise, and not anchor 2 because the "what" is clear rather than vague.

3 / 5

Trigger Term Quality

Terms like "VirtualMCPServer", "locally", "manual testing", and "verification" are relevant, but common variations a user would naturally say are missing — no "vMCP", "Kind cluster", "local cluster", or "MCP endpoint" phrasing. This is anchor 3 ("Some relevant keywords but missing common variations or synonyms"); it exceeds anchor 2 because the keywords are domain-specific rather than generic, but falls short of anchor 4's good coverage with natural synonyms.

3 / 5

Distinctiveness Conflict Risk

"VirtualMCPServer" is a highly specific CRD name, so this description carves out a clear niche with minimal risk of triggering for unrelated skills. This matches anchor 5 ("Clear niche with distinct triggers; minimal conflict risk"); anchor 4 would apply only if there were meaningful overlap with closely related skills, which the specific VirtualMCPServer term avoids.

5 / 5

Total

14

/

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
stacklok/toolhive
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.