CtrlK
BlogDocsLog inGet started
Tessl Logo

multi-url-environment-reference-custom-commands

How to author custom commands for the multi-url-environment-reference CLI using the co-generated SDK.

60

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

—

The risk profile of this skill

Fix and improve this skill with Tessl

tessl review fix ./seed/cli/multi-url-environment-reference/.agents/skills/custom-commands/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The content is a strong, actionable reference: complete executable Rust examples, concrete commands, and clear regeneration-safety guidance with minimal verbosity. The main gaps are the absence of an error-recovery feedback loop in the workflow and modest redundancy between the architecture, key-patterns, and regeneration sections.

DimensionReasoningScore

Conciseness

The body is efficient — a complete code example, a compact client table, and short build/test commands with no padding or explanations of concepts Claude already knows. Minor trims are possible (the Regeneration Safety table restates the '.fernignore' protection already noted inline, and 'Key Patterns' re-shows code from the main example), so it fits anchor 4 rather than anchor 5's 'every token earns its place'.

4 / 5

Actionability

The guidance is fully executable: a copy-paste-ready `register()` Rust example with the exact `super::sdk::client(ctx)` / `block_on` calls, a table of concrete sub-client types, the auth env var name, and exact `cargo build` / run / `RUST_LOG=debug` commands. This matches anchor 5 (copy-paste ready code covering the common cases); anchor 4 would require minor gaps that are not present.

5 / 5

Workflow Clarity

The sequence is clear — edit `custom.rs`, build, run the command, with a debugging checkpoint (`RUST_LOG=debug`) — and regeneration behavior is explicitly documented. It falls short of anchor 5 because there is no error-recovery feedback loop (what to do when the build fails or the SDK surface changed beyond the one-line note); the operation is not destructive/batch, so no cap applies.

4 / 5

Progressive Disclosure

No bundle files exist or are needed, and the body is well organized into clearly labeled sections. It sits at anchor 4 rather than 5 because the skill exceeds the ~50-line simple-skill threshold and content like the SDK client table and Regeneration Safety details could live in a separate reference file, though everything is currently modest in size and easy to navigate.

4 / 5

Total

17

/

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 appropriately narrow and names a concrete task for a specific CLI, giving it strong distinctiveness. However, it lacks any 'Use when...' trigger guidance and natural keyword variations, and it names only one action, leaving completeness, trigger quality, and specificity at mid-level.

Suggestions

Add an explicit trigger clause, e.g. 'Use when adding or modifying commands in the multi-url-environment-reference CLI, or when asked to extend or customize its commands.'

Include natural user phrasings and synonyms such as 'add a command', 'extend the CLI', 'custom subcommand' alongside 'custom commands'.

List one or two more concrete actions (e.g. 'register commands, call the generated SDK, rebuild with cargo') to raise specificity.

DimensionReasoningScore

Specificity

The description names the domain ('custom commands for the multi-url-environment-reference CLI') and one concrete action chain ('author custom commands ... using the co-generated SDK'), but coverage is not comprehensive — build, registration, and regeneration behavior are only implied by the noun phrase. It matches anchor 3 (names domain and 1-2 concrete actions, not comprehensive): it is more concrete than anchor 2's generic 'Processes PDF files', but lists fewer specific actions than anchor 4.

3 / 5

Completeness

It answers 'what' clearly (author custom commands using the co-generated SDK) but has no 'Use when...' clause or equivalent trigger guidance; per the judging guidelines a missing 'Use when...' caps completeness at 3. Not score 2 because the 'what' is concrete, not vague; not 4 because 'when' is entirely absent rather than weakly implied.

3 / 5

Trigger Term Quality

'custom commands', 'CLI', and 'SDK' are relevant keywords, but common natural variations ('add a command', 'extend the CLI', 'new command') and synonyms are missing, and the highly technical CLI name is not something a user would naturally say. Fits anchor 3 (some relevant keywords but missing common variations or synonyms): better than anchor 2's generic coverage, short of anchor 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

The description targets a single named CLI's custom-command authoring — a clear niche with distinct triggers and minimal conflict risk with other skills. This clearly matches anchor 5; no neighboring anchor fits better since the scope is unambiguously narrow.

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
fern-api/fern
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.