CtrlK
BlogDocsLog inGet started
Tessl Logo

plan

Strategic planning with optional interview workflow

56

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

Quality

Content

77%

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

The body is highly actionable and clearly sequences its complex consensus workflow with validation gates and feedback loops. Its weaknesses are redundancy — the same handoff and mode-selection guidance is restated several times — and a monolithic structure with reference material inlined rather than split into bundle files.

Suggestions

Deduplicate the consensus execution-handoff guidance: the $ultragoal/$team/$ralph staffing, reasoning levels, and launch-hint details are repeated nearly verbatim in steps 6-9, Tool_Usage, and Escalation_And_Stop_Conditions — consolidate to one canonical location and reference it.

Move the Advanced reference material (design-option presentation format, question-classification table, review-quality criteria) into a separate references/ file linked from the main body to break up the monolithic 278-line file.

Trim repeated policy: RALPLAN-DR short-vs-deliberate mode selection appears in Execution_Policy, Steps, Tool_Usage, and Final_Checklist — state it once and cross-reference.

DimensionReasoningScore

Conciseness

The 278-line body restates the same guidance nearly verbatim multiple times — the $ultragoal/$team/$ralph handoff details recur in steps 6-9, Tool_Usage, and Escalation, and RALPLAN-DR mode selection repeats across Execution_Policy, Steps, Tool_Usage, and Final_Checklist. It is substantive domain policy rather than filler concept explanation, so it clears the level 1 bar but is not lean, fitting 'Mostly efficient but includes some unnecessary explanation or could be tightened'.

2 / 3

Actionability

As an instruction-only skill it gives concrete, executable guidance: named modes with triggers, numbered step sequences, specific tool calls (AskUserQuestion, omx question, explore agent, ask_codex with agent_role), file paths (.omx/plans/), and exact required plan sections (RALPLAN-DR summary, ADR). Per the scoring note, absence of code is not penalized when guidance is this actionable, matching the fully-executable level 3 anchor.

3 / 3

Workflow Clarity

Consensus mode is a clearly sequenced multi-step process with explicit validation checkpoints (Architect must complete before Critic, 'Wait for this step to complete before proceeding'), a feedback loop (re-review up to 5 iterations with revise-and-re-evaluate), explicit stop conditions, and a Final_Checklist. This matches the level 3 anchor of clear sequence with validation steps and feedback loops for error recovery.

3 / 3

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent) and the entire skill is one 278-line monolithic SKILL.md. It is well-organized into sections, but reference-style material such as the Advanced section (design-option presentation, question-classification table, review-quality criteria) is inline that could be split into a separate reference file, fitting 'Some structure but could be better organized; content that should be separate is inline'. It does not qualify for the under-50-lines simple-skill exception.

2 / 3

Total

10

/

12

Passed

Description

50%

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 and identifies the planning domain plus an interview mode, but it omits any explicit trigger guidance and relies on somewhat jargony phrasing, so every dimension lands at the midpoint. Adding a concrete 'Use when...' clause with natural user phrases and listing the skill's concrete actions would raise specificity, completeness, and trigger quality.

Suggestions

Add an explicit trigger clause naming natural user phrases, e.g. 'Use when the user says "plan this", "let's plan", or needs to scope a vague idea before coding; also use for "review this plan" or "--consensus" multi-perspective planning.'

List concrete actions the skill performs, e.g. 'Interviews the user one question at a time, gathers codebase facts via an explore agent, generates testable work plans, and runs a Planner/Architect/Critic consensus loop.'

Replace jargon like 'interview workflow' with user-natural phrasing so the trigger terms read as things a user would actually say.

DimensionReasoningScore

Specificity

The phrase "Strategic planning with optional interview workflow" names the planning domain and one feature (interview mode) but does not list multiple concrete actions, matching the anchor 'Names domain and some actions, but not comprehensive'. It is above the vague 'Helps with documents' anchor but below the multi-action level 3 example.

2 / 3

Completeness

The description answers what (strategic planning) but provides no explicit 'Use when...' trigger clause, so it sits at 'Has what, but when is missing or only implied'. Per the rubric guideline, a missing Use-when clause caps completeness at 2.

2 / 3

Trigger Term Quality

"Strategic planning" is a reasonably natural term, but "interview workflow" leans toward jargon and the description omits common user phrasings like 'plan this'. This fits 'Some relevant keywords but missing common variations'. It does not reach the broad natural-term coverage of the level 3 anchor.

2 / 3

Distinctiveness Conflict Risk

"Strategic planning" is a recognizable niche but 'planning' is generic enough in an agentic context to overlap with other planning/execution skills, matching 'Somewhat specific but could still overlap with similar skills'. It is not the fully-distinct niche of the level 3 anchor.

2 / 3

Total

8

/

12

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.

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