plano-cli-operations

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

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

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

Quality

Content

65%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A tight, well-structured operational skill, but it stops short of being executable: the referenced rules are not bundled, exact commands are not given, and validation feedback loops are implicit. Resolving the dangling rule references and adding concrete commands would lift the weakest dimensions.

Suggestions

Add the actual CLI commands for startup validation, cli_agent routing, and 'planoai init' templates instead of only naming them in quotes.

Either bundle the cli-startup/cli-agent/cli-init rules as reference files or inline their content, so the 'Apply These Rules' section is not a dead reference.

Insert an explicit validation checkpoint (e.g. 'run planoai doctor / verify the agent connects') into the execution checklist with a fix-and-retry loop.

Dimension	Reasoning	Score
Conciseness	Lean and token-efficient with no explanation of concepts Claude already knows; every line is operational and earns its place.	3 / 3
Actionability	Names CLI commands like 'planoai up', 'planoai cli_agent', and 'planoai init' but only inside illustrative quotes; the checklist directs to 'provide a compact runbook with exact CLI commands' without actually providing them.	2 / 3
Workflow Clarity	A numbered checklist gives a sequence, but validation checkpoints are only implicit ('Follow startup validation order') with no explicit validate-fix-retry feedback loop for the risky startup/bootstrapping operations.	2 / 3
Progressive Disclosure	Sections are well organized, but 'Apply These Rules' references cli-startup/cli-agent/cli-init that have no corresponding bundle files, leaving dangling references that should be either resolved or kept inline.	2 / 3
	Total	9 / 12 Passed

Description

85%

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 concise, third-person description that answers both what and when with an explicit trigger clause and a clear Plano CLI niche. Weakest point is trigger-term naturalness, where jargon like 'cli_agent workflows' replaces phrasing users would actually say.

Suggestions

Replace jargon triggers with natural user phrasing, e.g. 'when planoai up won't start' or 'when setting up a new Plano project'.

Consider adding '.planoai' or the tool name as an explicit keyword so it surfaces on direct mentions.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions (startup troubleshooting, cli_agent workflows, template-based project bootstrapping) under the Plano CLI domain rather than vague abstractions.	3 / 3
Completeness	States what it does ('Apply Plano CLI best practices') and gives an explicit 'Use for ...' trigger clause covering when Claude should invoke it.	3 / 3
Trigger Term Quality	Includes relevant triggers like 'startup troubleshooting' and 'template-based bootstrapping', but 'cli_agent workflows' is technical jargon and common natural variations a user would say are missing.	2 / 3
Distinctiveness Conflict Risk	Scoped to the Plano CLI niche with distinct triggers, making it unlikely to fire for unrelated skills.	3 / 3
	Total	11 / 12 Passed

Validation

100%

Warnings & errors only

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
Path: skills/plano-cli-operations/SKILL.md
Commit: d23e276

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

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.