CtrlK
BlogDocsLog inGet started
Tessl Logo

plan

Lightweight planning with optional interview

50

Quality

63%

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/plan/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 a well-structured, mostly lean instruction workflow with concrete tools, flags, thresholds, sequenced modes, and a review feedback loop. Its main weaknesses are minor redundancy, a few abstract steps, and the absence of an explicit validation checkpoint before saving plans.

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's competence, with only minor trimmable redundancy (the 'omx explore is deprecated' note appears in both Execution_Policy and Tool_Usage) and some opaque jargon in the outcome-first framing paragraph; it stays above 3 because padding is minimal.

4 / 5

Actionability

It gives concrete guidance via specific tools (omx question, ask_codex with planner/analyst/critic), flags (--interview/--direct/--review), paths (.omx/plans/), and thresholds (80%+ file/line, 90%+ testable), with only minor gaps; it does not reach 5 because some steps remain abstract ('consult Analyst', 'Build on answers').

4 / 5

Workflow Clarity

Interview/Direct/Review modes are clearly sequenced with numbered steps, a Final_Checklist, escalation/stop conditions, and a review verdict loop (APPROVED/REVISE/REJECT); it falls below 5 because the main planning flow lacks an explicit validate-before-save checkpoint.

4 / 5

Progressive Disclosure

The skill is self-contained with well-labeled sections (Purpose, Use_When, Steps, Advanced) and no nested references; with no external files needed and clear organization it scores well, but at ~90 lines it does not meet the under-50-line simple-skill exception for an automatic 5.

4 / 5

Total

16

/

20

Passed

Description

32%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 a minimal five-word phrase that identifies the planning domain but provides no concrete actions, no use-when trigger guidance, and limited distinctiveness. It is too thin to score above the low-mid range on most dimensions.

Suggestions

Add concrete actions the skill performs, e.g. 'Creates concise, evidence-backed work plans with acceptance criteria and saves them to .omx/plans/'.

Append an explicit trigger clause such as 'Use when the user says plan this, let's plan, or needs to scope vague requirements before implementation.'

Add distinguishing details (interview vs direct modes, --review) to reduce overlap with generic goal/task skills.

DimensionReasoningScore

Specificity

The description names the domain ("planning") and one feature ("optional interview") but lists no concrete actions, matching the anchor 'Names the domain but actions are minimal or generic'; it does not reach 3 because no specific actions are enumerated.

2 / 5

Completeness

It gives a vague "what" ("Lightweight planning") and provides no "when"/trigger guidance at all, matching 'Has a vague what and no when'; it falls below 3 because the what is terse rather than clearly concrete.

2 / 5

Trigger Term Quality

"planning" is a natural term users say, but the description offers only that single keyword with no common variations or synonyms (e.g. "plan this", "scope", "requirements"), fitting 'Some relevant keywords but missing common variations'.

3 / 5

Distinctiveness Conflict Risk

"Lightweight planning" is very broad and would overlap with many planning/goal/task skills; the "optional interview" modifier adds only minor specificity, fitting 'Very broad; high overlap risk with many similar skills'.

2 / 5

Total

9

/

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
Yeachan-Heo/oh-my-codex
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.