CtrlK
BlogDocsLog inGet started
Tessl Logo

nullable-allof-extends-test-custom-commands

How to author custom commands for the nullable-allof-extends-test CLI using the co-generated SDK.

58

Quality

73%

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/nullable-allof-extends/.agents/skills/custom-commands/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

68%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 tight, actionable skill body with real executable Rust code and a useful regeneration-safety table. Its main weaknesses are the missing explicit validation step in the workflow and the dangling empty sub-clients section.

Suggestions

Add an explicit validation checkpoint to the workflow, e.g. after editing run 'cargo build' and confirm the command appears via 'nullable-allof-extends-test --help' before exercising it.

Fill in or remove the empty 'Available SDK Clients' section: either list the actual sub-clients (or show how to discover them from the SDK crate) or drop the 'with the following sub-clients:' lead-in entirely.

Deduplicate the 'Key Patterns' section against the full code example, or shrink the example so the patterns section carries the detail once.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence (no explanation of Rust, clap, or codegen concepts), but the 'client(ctx)' and 'block_on' patterns are shown in the full example and repeated in 'Key Patterns', and the parenthetical '(Sub-clients are derived from the API spec at generation time.)' could be trimmed. These minor instances of redundancy fit the 'efficient with minor over-explanation' anchor rather than 'every token earns its place'.

4 / 5

Actionability

Provides a complete, structurally executable Rust registration example plus concrete 'cargo build', run, and 'RUST_LOG=debug' commands. Minor gaps: the 'Available SDK Clients' section promises 'the following sub-clients:' but lists none, and 'client.resource.get(id)' uses a placeholder resource name, keeping it just below fully copy-paste ready.

4 / 5

Workflow Clarity

The edit -> build -> run sequence is present and regeneration behavior is well documented, but validation checkpoints are implicit at best; the only verification aid is the RUST_LOG=debug flag, with no step like 'confirm the command appears in --help' or 'verify cargo build compiles before running'. This matches 'steps listed but validation gaps; checkpoints missing or implicit' rather than the anchor-4 example that includes an explicit verify step.

3 / 5

Progressive Disclosure

With no bundle files, the ~100-line body is appropriately self-contained and well-sectioned (Overview / Architecture / Adding a Custom Command / Regeneration Safety / Build & Test). The empty 'Available SDK Clients' stub that promises a list it never delivers is a minor organization gap that keeps it from a 5.

4 / 5

Total

15

/

20

Passed

Description

65%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 concise, specific to a single named CLI, and highly distinctive, but it answers only "what" and not "when". Adding an explicit trigger clause and one or two more concrete actions would raise it substantially.

Suggestions

Add a 'Use when...' clause, e.g. 'Use when adding or modifying commands in the nullable-allof-extends-test CLI or when the user mentions extending this CLI with custom commands.'

List one or two more concrete actions beyond 'author', such as 'register commands in custom.rs' and 'call the co-generated SDK client', to improve specificity coverage.

Include a natural synonym or two users might say, like 'extend the CLI' or 'add a command', to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

Names the exact domain ("the nullable-allof-extends-test CLI") and one concrete action ("author custom commands"), but lists no further actions such as registering commands or wiring up the SDK client. This matches the anchor for naming a domain with 1-2 concrete actions that are not comprehensive.

3 / 5

Completeness

The "what" is clear ("author custom commands ... using the co-generated SDK"), but there is no "Use when..." clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines.

3 / 5

Trigger Term Quality

"custom commands", "CLI", and "SDK" are natural terms a user working in this repo would say, giving good keyword coverage. Not 5 because synonyms like "extend the CLI", "add commands", or "fern generate" are missing.

4 / 5

Distinctiveness Conflict Risk

Naming the specific CLI ("nullable-allof-extends-test") carves out a clear niche with distinct triggers and minimal risk of firing for the wrong skill.

5 / 5

Total

15

/

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.