CtrlK
BlogDocsLog inGet started
Tessl Logo

metalbear/mirrord-config

Helps users generate, edit, and validate mirrord.json configuration files for mirrord (MetalBear). Use when the user wants to connect their local process to a Kubernetes environment, configure features (env/fs/network), or needs feedback on an existing mirrord.json. Always ensures output JSON is valid and schema-conformant.

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, highly actionable skill body with a mandatory validation workflow, real one-level-deep references, and concrete examples covering common cases. Its only inefficiency is repeating the fs.mode local-by-default and minimality messages across multiple sections.

DimensionReasoningScore

Conciseness

The body is largely efficient and additive (defaults, pitfalls, exact key syntax), but the 'local code is already local' point is repeated across three sections ('Your code is local by default', 'Do not add config speculatively', 'Common Pitfalls') and the minimality rule is restated three ways ('Default to minimal configs', 'Prefer minimal configs', 'Minimal configs are a hard requirement'). Minor trimmable over-explanation fits anchor 4 rather than anchor 5's 'every token earns its place'.

4 / 5

Actionability

Guidance is fully executable: copy-paste-ready example config JSON, exact commands (`which mirrord`, `mirrord verify-config <file>`), concrete key/value snippets ("target": "pod/name", "env": {"include": "VAR1;VAR2"}), JSON Pointer error notation, and a worked example scenario. Matches anchor 5's 'copy-paste ready code or commands' covering the common cases.

5 / 5

Workflow Clarity

Clear sequence ('Critical First Steps' 1-2-3) with explicit validation checkpoints and a feedback loop ('If any validation fails: Parse error messages → Fix the config → Re-validate until success') plus 'Validate before presenting' enforcement. Matches anchor 5's 'explicit validation steps; feedback loops for error recovery'.

5 / 5

Progressive Disclosure

The body is an overview plus core guidance, and both bundle files (references/schema.json, references/configuration.md — verified to exist) are clearly signaled with paths, purposes, and section-level pointers ('references/configuration.md → "fs.mode internals"', verified present at line 1821). References are one level deep and easy to navigate, matching anchor 5.

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 in third-person voice with explicit what and when clauses and concrete, tool-specific trigger phrases. The only gap is a few missing natural synonyms (e.g. traffic mirroring/stealing terms) that a user might use when asking for this skill.

DimensionReasoningScore

Specificity

"Helps users generate, edit, and validate mirrord.json configuration files" plus "feedback on an existing mirrord.json" and "Always ensures output JSON is valid and schema-conformant" lists multiple concrete actions covering all of the skill's request types. Matches the anchor-5 example's comprehensiveness rather than anchor 4's 'minor gaps in coverage'.

5 / 5

Completeness

Explicitly answers what ("generate, edit, and validate mirrord.json configuration files for mirrord (MetalBear)") and when ("Use when the user wants to connect their local process to a Kubernetes environment, configure features (env/fs/network), or needs feedback on an existing mirrord.json") with concrete trigger phrases, exactly matching anchor 5. Anchor 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

"connect their local process to a Kubernetes environment", "configure features (env/fs/network)", and "mirrord.json" are natural user phrasings, but common synonyms such as "mirror traffic", "steal traffic", or "debug in cluster" are missing. Good coverage with a few natural terms absent fits anchor 4, not the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The named niche tool "mirrord (MetalBear)" and the file-specific triggers (mirrord.json, connecting a local process to Kubernetes) give it a clear niche with minimal conflict risk, matching anchor 5. Generic 'validate JSON' phrasing alone could overlap with a JSON skill, but the mirrord-specific framing keeps it distinct.

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