CtrlK
BlogDocsLog inGet started
Tessl Logo

plano-cli-operations

Apply Plano CLI best practices. Use for startup troubleshooting, cli_agent workflows, and template-based project bootstrapping.

48

Quality

51%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/plano-cli-operations/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

40%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 commendably lean and well-sectioned, but it is a shell: it points to rules, a 'startup validation order', and a runbook that are all absent, and contains zero executable commands. A Claude loading this skill would learn what topics matter but not what to actually do.

Suggestions

Add actual executable examples for each command, e.g. `planoai up`, `planoai cli_agent --agent claude`, and `planoai init --template <name>`, since the skill's own checklist demands 'a compact runbook with exact CLI commands'.

Create the referenced rule files (e.g. references/cli-startup.md, cli-agent.md, cli-init.md) or inline the rules, and link them explicitly so `cli-startup`/`cli-agent`/`cli-init` are not dangling names.

Define the 'startup validation order' as an explicit ordered checklist with validation checkpoints (e.g. check daemon status, verify config, inspect logs) so step 1 of the Execution Checklist is actionable.

DimensionReasoningScore

Conciseness

The ~30-line body is lean, assumes Claude's competence, and contains no concept explanations or padding — every section carries information. It misses anchor 5 only because the Execution Checklist partly restates the When To Use bullets (items 2-3 restate the cli_agent and init bullets), a minor redundancy that could be trimmed.

4 / 5

Actionability

The body names real subcommands ("planoai up", "planoai cli_agent", "planoai init") but never shows a single executable command, example, or syntax — it even instructs Claude to "Provide a compact runbook with exact CLI commands" without supplying any. "Follow startup validation order" references an order that is never defined. This matches anchor 2 (minimal concrete guidance; high-level hints missing the specific steps), not anchor 3, because nothing here can be executed or followed concretely.

2 / 5

Workflow Clarity

The Execution Checklist is numbered but is a list of principles rather than a processable sequence: "Follow startup validation order before deep debugging" is undefined, and there are no validation checkpoints or error-recovery steps anywhere. This fits anchor 2 (rough sequence present but many gaps; steps poorly defined; validation absent) better than anchor 3, whose steps at least map to a real sequence of operations.

2 / 5

Progressive Disclosure

The "Apply These Rules" section lists rule names (`cli-startup`, `cli-agent`, `cli-init`) but no bundle files exist — there are no references/, scripts/, or assets/ directories — so those references are dangling and the actual operational content is unreachable. Sections themselves are organized, but per the guideline to score against the actual bundle structure, references pointing at nonexistent content score at anchor 2 (minimal structure; references are buried/broken) rather than 3.

2 / 5

Total

10

/

20

Passed

Description

62%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 covers both what and when with a clear niche. Its main weaknesses are a generic leading action ('apply best practices') and trigger terms that name task categories instead of the concrete commands (planoai up, planoai init) a user would actually mention.

Suggestions

Replace the vague action 'Apply Plano CLI best practices' with concrete verbs, e.g. 'Diagnose planoai up startup failures, route coding-agent traffic through planoai cli_agent, and bootstrap projects with planoai init templates.'

Include the actual CLI command names (planoai up, planoai cli_agent, planoai init) in the trigger clause, since users asking for help will naturally type those commands.

The 'when' clause would be stronger with user-facing phrasing such as 'Use when planoai up fails to start, when wiring coding agents through Plano, or when initializing a new Plano project from templates.'

DimensionReasoningScore

Specificity

The description names a concrete domain ("Plano CLI") and lists three task areas ("startup troubleshooting, cli_agent workflows, and template-based project bootstrapping"), but the leading action "Apply Plano CLI best practices" is generic — it describes areas of coverage rather than specific actions. This matches anchor 3 (names domain and 1-2 concrete actions, not comprehensive) and falls short of anchor 4, which expects several specific actions like 'Extracts text..., fills forms, converts...'.

3 / 5

Completeness

Both parts are present: the 'what' is "Apply Plano CLI best practices" and an explicit 'when' clause exists ("Use for startup troubleshooting, cli_agent workflows, and template-based project bootstrapping"). This earns anchor 4 rather than 5 because the 'what' is vague — 'apply best practices' does not state what the skill actually does — and the 'when' clause names categories rather than concrete trigger phrases.

4 / 5

Trigger Term Quality

"startup troubleshooting" and "template-based project bootstrapping" are reasonable natural phrases, but the description misses the actual commands users would type ("planoai up", "planoai init") and common variations like "planoai". Anchor 3 (some relevant keywords but missing common variations or synonyms) fits better than anchor 4, since the most natural trigger terms a Plano user would say are absent.

3 / 5

Distinctiveness Conflict Risk

The Plano CLI niche ("cli_agent workflows", "Plano") is clearly distinct from generic CLI or document skills, giving minimal conflict risk. It does not reach anchor 5 only because "startup troubleshooting" alone is somewhat generic and the description omits the distinctive 'planoai' command names that would fully seal the niche.

4 / 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
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.