CtrlK
BlogDocsLog inGet started
Tessl Logo

metalbear/mirrord-quickstart

Guide users from zero to their first working mirrord session — check system requirements, install mirrord via CLI, VS Code, or IntelliJ, run a first session against a Kubernetes target, and verify the connection. Use when a user is new to mirrord, wants to install it, needs help running their first session, or wants to debug or test a local process against their Kubernetes cluster.

75

Quality

94%

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

Overview
Quality
Evals
Security
Files

Quality

Content

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

A well-structured quickstart with fully executable commands, explicit verification steps, and error-recovery guidance, appropriately deferring advanced features to other skills and official docs. The only flaw is a three-fold repetition of the install-security warning, which slightly inflates the install section.

DimensionReasoningScore

Conciseness

Lean overall — no explanation of concepts Claude already knows, and commands/examples earn their tokens. Not 5: the no-pipe-to-shell security point is repeated three times ('**Do not** run remote install scripts...', 'do not invent or paste one-liners...', and the blockquote 'Never execute installation by piping downloaded content into a shell'), which could be collapsed to one statement. Not 3: the repetition is minor, not 'some unnecessary explanation' padding.

4 / 5

Actionability

Fully executable, copy-paste-ready guidance: 'kubectl cluster-info', 'mirrord --version', 'mirrord ls', 'mirrord exec --target pod/api-server-7c8d9 -- node app.js', 'env | grep -i database', 'curl http://<remote-service-url>', plus numbered IDE install steps and concrete examples for both Node.js and Python.

5 / 5

Workflow Clarity

Clear sequence (detect environment → verify requirements → install → first session → verification) with explicit validation checkpoints (logs, env vars, network) and error-recovery feedback loops ('If kubectl fails, help them configure it first', 'If `mirrord ls` returns no targets...', and the troubleshooting table).

5 / 5

Progressive Disclosure

A single, well-sectioned file with no bundle files to misplace; advanced material is correctly deferred one level deep via the 'What's Next' pointers to other skills (mirrord-up, mirrord-operator) and official docs, with clear section navigation throughout. Not 4: there is no misplaced inline bulk content or unclear reference signaling.

5 / 5

Total

19

/

20

Passed

Description

92%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 description: concrete, comprehensive action list plus an explicit 'Use when' clause with natural trigger phrases, all in third person. The only weakness is a few missing synonyms ('K8s', 'mirror traffic'), leaving trigger coverage just short of the top anchor.

DimensionReasoningScore

Specificity

Lists multiple concrete actions naming the tool and all three install paths ('check system requirements, install mirrord via CLI, VS Code, or IntelliJ, run a first session against a Kubernetes target, and verify the connection'), comprehensively covering the quickstart scope. Not 4: no coverage gap is evident — the action list spans requirements, install, session, and verification exactly as the 5-anchor example does.

5 / 5

Completeness

Explicitly answers both 'what' (the enumerated action list) and 'when' via a literal 'Use when a user is new to mirrord...' clause with multiple concrete triggers — a direct match to the 5 anchor. The 3-cap for a missing 'Use when' clause does not apply.

5 / 5

Trigger Term Quality

Natural phrases users would say are present ('new to mirrord', 'wants to install it', 'debug or test a local process against their Kubernetes cluster'). Not 5: a few natural synonyms are missing (e.g., 'K8s', 'mirror production traffic', 'intercept'); not 3: keyword coverage is good rather than merely partial.

4 / 5

Distinctiveness Conflict Risk

'mirrord' is a distinct named tool and the triggers ('new to', 'install', 'first session') carve out the beginner niche clearly, separating it from the advanced mirrord-up and mirrord-operator skills referenced in the body. Minimal conflict risk with any other skill.

5 / 5

Total

19

/

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.

Reviewed

Table of Contents