CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

create-cli

Design command-line interface parameters and UX: arguments, flags, subcommands, help text, output formats, error messages, exit codes, prompts, config/env precedence, and safe/dry-run behavior. Use when you’re designing a CLI spec (before implementation) or refactoring an existing CLI’s surface area for consistency, composability, and discoverability.

Quality

92%

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

SKILL.md
Quality
Evals
Security

Quality

Content

86%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, token-efficient design skill: it points to a real one-level-deep reference for the detailed rubric, provides a fully actionable clarify-then-spec workflow, and includes a copy-paste spec template with concrete defaults. The main improvement opportunities are consolidating flag conventions that repeat across sections and adding an explicit validation pass over the finished spec.

Suggestions

Consolidate the flag/output conventions (--json/--plain, --no-input, quiet/verbose, dry-run/confirmation) that currently repeat across "Clarify", "Deliverables", "Default Conventions", and the Template into a single section that the others reference.

Add an explicit validation checkpoint at the end of the workflow, e.g., "Before delivering, re-check the spec against references/cli-guidelines.md and the Deliverables list" to close the workflow-clarity gap.

DimensionReasoningScore

Conciseness

The body is lean and telegraphic ("Primary data to stdout; diagnostics/errors to stderr"), assuming Claude's competence with no concept explanations. However, the same flags and conventions (--json/--plain, --no-input, dry-run/confirmation, quiet/verbose) recur across "Clarify", "Deliverables", "Default Conventions", and the Template, which could be consolidated. Not 5 due to this cross-section repetition; not 3 because there is no padding or explanation of known concepts.

4 / 5

Actionability

For an instruction-only design skill, the guidance is fully actionable: a concrete clarifying-question list, a deliverables checklist ("Command tree + USAGE synopsis", "Error + exit code map", "5-10 example invocations"), and a copy-paste-ready spec skeleton with concrete defaults (exit codes 0/1/2, precedence "flags > env > project config > user config > system", NO_COLOR/TERM=dumb handling). Per the scoring notes, absence of code is not penalized when guidance is this specific.

5 / 5

Workflow Clarity

The sequence is explicit and ordered: "Do This First" (read references/cli-guidelines.md, ask minimum questions) -> "Clarify (fast)" with a fallback checkpoint ("Ask, then proceed with best-guess defaults if user is unsure") -> "Deliverables" -> template. Not 5 because there is no validation step for the produced spec (e.g., cross-check the final spec against the guidelines file before delivering). Not 3 because the sequence is explicit rather than implicit and a clarify-with-fallback checkpoint exists; the destructive/batch validation cap does not apply to this design skill.

4 / 5

Progressive Disclosure

The body is a concise overview with a single, clearly signaled, one-level-deep reference ("Read `references/cli-guidelines.md` from this skill directory and apply it as the default rubric") that verifiably exists in the bundle; the bulk guideline detail lives in that 239-line file. Structure is easy to navigate with distinct sections for clarify/deliver/conventions/template. Not 4 because no content that belongs in the reference is inlined at problematic scale.

5 / 5

Total

18

/

20

Passed

Description

95%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: it names the domain comprehensively, provides explicit 'Use when' triggers with a useful before-implementation boundary, and includes synonym keywords (command-line interface, CLI). Its only flaw is second-person voice ("you're designing") in the trigger clause, which costs it a specificity point under the rubric's voice rule.

DimensionReasoningScore

Specificity

The description enumerates ten-plus concrete capability areas ("arguments, flags, subcommands, help text, output formats, error messages, exit codes, prompts, config/env precedence, and safe/dry-run behavior"), which matches the comprehensive anchor 5, but "Use when you're designing a CLI spec" uses second-person voice, which the judging guidelines penalize by one point. Not anchor 3 because far more than 1-2 actions are named; not 5 due to the voice penalty.

4 / 5

Completeness

Clearly answers both questions: the 'what' is explicit ("Design command-line interface parameters and UX: arguments, flags, ... safe/dry-run behavior") and the 'when' is explicit with concrete triggers ("Use when you're designing a CLI spec (before implementation) or refactoring an existing CLI's surface area"). Matches the anchor-5 example pattern of concrete what followed by 'Use when...' phrasing.

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage with synonyms present: "command-line interface" and "CLI" both appear, alongside "arguments", "flags", "exit codes", "CLI spec", and "refactoring an existing CLI". Users designing or refactoring command-line tools would naturally say these terms. Not 4 because both synonym forms and the component vocabulary users actually invoke are covered.

5 / 5

Distinctiveness Conflict Risk

Clear niche (CLI surface/UX design) with distinct triggers, and the "(before implementation)" qualifier explicitly separates it from CLI implementation/coding skills. Minor theoretical overlap with general design skills, but the trigger phrasing targets exactly the spec-design case. Not 4 because the before-implementation boundary plus CLI-specific vocabulary make conflict risk minimal.

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.

Repository

ollygarden/ollygarden-cli

Path

.agents/skills/create-cli/SKILL.md

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.