CtrlK
BlogDocsLog inGet started
Tessl Logo

build-cli

Build and install the Python CLI (planoai). Use after making changes to cli/ code to install locally.

68

Quality

83%

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

100%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 body is an exemplary minimal workflow: fully executable commands, an explicit verification step, and an error-recovery fallback, with zero padding and no unnecessary structure for a skill of this size. All dimensions land at the top anchor.

DimensionReasoningScore

Conciseness

The body is four lines of lean, executable commands with one short annotation each ("ensure dependencies are installed", "install the CLI locally") and a single error-recovery sentence — no concept explanations or padding. It matches anchor 5 ('Lean and efficient; assumes Claude's competence; every token earns its place') rather than 4, which would require minor over-explanation to trim.

5 / 5

Actionability

All three steps are copy-paste-ready commands (`cd cli && uv sync`, `cd cli && uv tool install --editable .`, `cd cli && uv run planoai --help`) covering the full build-install-verify flow. This matches anchor 5 ('Fully executable; copy-paste ready code or commands') — anchor 4 would imply minor gaps, and none are present.

5 / 5

Workflow Clarity

A clear numbered sequence with an explicit verification checkpoint (step 3: `uv run planoai --help`) and a feedback loop ("If the build or install fails, diagnose and fix the issues") matching anchor 5 ('Clear sequence with explicit validation steps; feedback loops for error recovery'). The operation is not destructive or batch, so no cap applies; anchor 4 would require a missing checkpoint, which step 3 provides.

5 / 5

Progressive Disclosure

This is a simple single-purpose skill under 50 lines with no bundle files (no references/, scripts/, or assets/ exist) and no external references needed; the numbered-list structure is well-organized for the content's size. Per the rubric's simple-skill guideline, this matches anchor 5 — a wall-of-text or inline-content-that-belongs-elsewhere (anchors 1-2) clearly does not apply to a 4-line body.

5 / 5

Total

20

/

20

Passed

Description

66%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, third-person, and clearly answers both 'what' and 'when' with a distinct, low-conflict trigger anchored to the planoai CLI name. Its weaknesses are limited action coverage and a thin set of trigger-term variations, which cap specificity and trigger-term quality at the mid range.

Suggestions

List the full action set in the description (e.g., 'Build, install, and verify the Python CLI (planoai)') to raise specificity beyond two actions.

Add natural trigger variations such as 'reinstall', 'rebuild', or 'uv tool' so the description fires when users phrase the need differently.

Broaden the 'when' clause beyond one trigger (e.g., 'Use after changing cli/ code, when the installed planoai command is stale, or when setting up the CLI') for a more explicit completeness match.

DimensionReasoningScore

Specificity

"Build and install the Python CLI (planoai)" names the domain (Python CLI, planoai) and exactly two concrete actions (build, install). It matches anchor 3 ('Names domain and 1-2 concrete actions, but not comprehensive') — not 4 because it does not list several actions (verification, dependency sync, uninstall are only in the body), and not 2 because the actions are concrete rather than generic.

3 / 5

Completeness

It explicitly answers both: what ("Build and install the Python CLI (planoai)") and when ("Use after making changes to cli/ code to install locally"), matching the anchor-4 example pattern ('Extract text from PDFs and fill forms. Use when working with PDF files.'). Not 5 because the 'when' clause is narrow — a single repo-specific trigger phrase — and lacks multiple concrete trigger phrases.

4 / 5

Trigger Term Quality

Relevant keywords are present ("planoai", "Python CLI", "install", "cli/ code") but common variations users would naturally say are missing ("reinstall", "rebuild", "uv tool", "CLI isn't picking up changes"). This fits anchor 3 ('Some relevant keywords but missing common variations or synonyms') rather than 4, which expects good coverage with only a few natural terms missing.

3 / 5

Distinctiveness Conflict Risk

"planoai" plus the explicit "Use after making changes to cli/ code" trigger carves out a clear niche with minimal conflict risk against generic build/install skills. It matches anchor 5 ('Clear niche with distinct triggers; minimal conflict risk'); anchor 4's 'minor overlap risk with closely related skills' would understate the name-level distinction the planoai identifier provides.

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
katanemo/plano
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.