CtrlK
BlogDocsLog inGet started
Tessl Logo

plan

Lightweight planning with optional interview

48

Quality

61%

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 ./plugins/oh-my-codex/skills/plan/SKILL.md

The canonical home for this skill is plan in Yeachan-Heo/oh-my-codex

SKILL.md
Quality
Evals
Security

Quality

Content

67%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 actionable instruction skill: mode triggers, per-mode sequences, tool names, and measurable quality gates are all concrete. Its main weaknesses are redundancy (duplicated deprecation note, triple-stated thresholds) and a confusing, misplaced 'Outcome-first framing' paragraph.

Suggestions

State the 'omx explore deprecated' note once (in Tool_Usage) and remove the duplicate in Execution_Policy

Move or rewrite the 'Outcome-first framing' paragraph — it sits under Output inside Steps and its 'Local overrides... newer user task updates' sentence is unclear

Consolidate the 80%/90% thresholds into one location (e.g. the Final Checklist) and reference it from the other sections

DimensionReasoningScore

Conciseness

The body is mostly lean, but the 'omx explore is deprecated' note appears verbatim in both Execution_Policy and Tool_Usage, the 80%/90% quality thresholds are repeated in Execution_Policy, Final_Checklist, and the Advanced review-criteria table, and the 'Outcome-first framing' paragraph is padded and confusing. Mostly efficient but could be tightened — anchor 3, not 4 because the redundancy goes beyond a single minor instance.

3 / 5

Actionability

Concrete guidance throughout: named tools with invocation hints (omx question, omx sparkshell, ask_codex with planner/analyst/critic), a mode-selection trigger table, a defined plan output format, and measurable thresholds (80% file/line citations, 90% testable criteria). Minor gaps — no example plan snippet and vague steps like 'consult Analyst for hidden requirements' — so anchor 4 rather than 5.

4 / 5

Workflow Clarity

Clear sequencing: a mode-selection table maps triggers to behaviors, each mode has numbered steps, output structure is specified, and the Final Checklist plus stop conditions serve as checkpoints. This is not a destructive or batch operation so no cap applies; minor validation gaps (e.g. no explicit 'verify file refs exist' step in the generation flow) keep it at anchor 4 rather than 5.

4 / 5

Progressive Disclosure

No bundle files exist and none are needed at this size; sections are clearly labeled (Purpose, Use_When, Steps, Tool_Usage, Advanced) and the Advanced material (question classification and review criteria tables) is compact enough to remain inline. Good structure with minor organization gaps (the misplaced 'Outcome-first framing' paragraph inside Steps) — anchor 4.

4 / 5

Total

15

/

20

Passed

Description

36%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 terse to a fault: it names the domain but omits concrete actions, trigger phrases, and any 'when to use' guidance. A user or model scanning skill descriptions would have little basis for selecting this skill over other planning-related ones.

Suggestions

Add concrete actions to the description, e.g. 'Creates concise, evidence-backed work plans with testable acceptance criteria, saved to .omx/plans/'

Add a 'Use when...' clause with natural trigger phrases, e.g. 'Use when the user asks to plan work, scope a vague request, or review an existing plan'

Mention the distinguishing features (Socratic --interview mode, --review evaluation, evidence-backed criteria) to differentiate from generic planning skills

DimensionReasoningScore

Specificity

'Lightweight planning with optional interview' names the domain (planning) and one mode (interview) but lists no concrete actions such as creating or reviewing work plans. It matches anchor 2 (names the domain but actions are minimal or generic); it is not level 3 because no specific action verbs like 'creates', 'saves', or 'evaluates' appear.

2 / 5

Completeness

The 'what' is vague ('Lightweight planning') and there is no 'Use when...' clause or any trigger guidance at all, which caps completeness at 3; the vague what plus missing when matches anchor 2 exactly. It is not level 1 because the domain is at least named.

2 / 5

Trigger Term Quality

'planning' is a natural keyword a user would say, but the description contains no synonyms or variations (e.g. 'plan', 'work plan', 'scope a task'). Some relevant keywords exist, yet common variations are missing — anchor 3 rather than 4.

3 / 5

Distinctiveness Conflict Risk

'Planning' is a broad domain that overlaps with other planning, roadmap, or task-breakdown skills; 'optional interview' narrows it slightly. Somewhat specific but still overlapping — anchor 3, not 4 which requires a clearly distinct niche.

3 / 5

Total

10

/

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.