CtrlK
BlogDocsLog inGet started
Tessl Logo

ralplan

Consensus planning stage for Planner -> Architect -> Critic handoff to $ultragoal

49

Quality

62%

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/ralplan/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

56%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 core consensus workflow is genuinely well-specified — concrete commands, exact record schemas, bounded feedback loops, and explicit sequencing — but it is buried in heavily padded, repetitive policy legalese that belongs in separate reference files. The document reads more like a compliance artifact than an efficient skill body, and its structural clutter (empty headings, duplicated usage sections, interleaved unnumbered policy) obscures an otherwise strong workflow.

Suggestions

Consolidate the advisory/security-boundary disclaimers, currently repeated in the advisory, ontology-review, handoff-contract, and goal-mode sections, into one concise statement or a dedicated reference file.

Move the durable handoff contract details and the native role-routing preflight rules to a references/ file, keeping SKILL.md to the workflow steps, flags, and handoff record shape.

Fix structural clutter: remove the empty '## Behavior' heading, fold 'Usage with interactive mode' into the Flags section, and relocate the role-routing paragraphs so the numbered consensus workflow reads as one uninterrupted sequence.

DimensionReasoningScore

Conciseness

The advisory-mode paragraph is a ~250-word single-block legalese sentence ('It is a cooperative workflow pause, not a security fence or permission system...'), and the 'local evidence is not host-issued authority' disclaimer repeats in at least four sections (advisory, ontology review, handoff contract, goal-mode suggestions). Anchor 2 fits: noticeably verbose with several padded sections; it avoids a 1 only because it does not explain concepts Claude already knows.

2 / 5

Actionability

Concrete commands ('$ralplan "task description"', 'omx ralplan run --task <arguments> [--session <id>]', 'omx ralplan preflight --json'), an exact handoff record schema ({authorized, reason, authorized_at, session_id, review_cycle, source}), and specific artifact paths ('.omx/context/{slug}-{timestamp}.md') give mostly executable guidance. Minor gaps keep it below 5: '<arguments>' is unspecified, 'Follow the Plan skill's full documentation' has no path, and the RALPLAN-DR summary's shape is only implied.

4 / 5

Workflow Clarity

The eight-step consensus loop has explicit sequencing ('await completion before step 4', 'Do NOT issue both agent calls in the same parallel batch'), a bounded re-review feedback loop (max 5 iterations with revise-and-return), and blocked-reviewer handling. Structural defects hold it at 4 rather than 5: the empty '## Behavior' heading (line 40), the unnumbered role-routing preflight paragraphs wedged between steps 2 and 3, and a second numbered intake sequence competing with the main workflow.

4 / 5

Progressive Disclosure

The body has section structure, but ~145 lines of dense policy prose (advisory boundaries, native role-routing rules, the durable handoff contract) are inlined in SKILL.md with no bundle files to offload detail to. References that do exist are vague or buried: 'Follow the Plan skill's full documentation' names no path, and 'templates/AGENTS.md' / 'src/hooks/keyword-registry.ts' appear mid-paragraph. Anchor 3: some structure, but content that should be separate is inline and references are not clearly signaled.

3 / 5

Total

13

/

20

Passed

Description

50%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 names the domain and its role pipeline but omits any 'when to use' trigger guidance and leans on internal jargon ($ultragoal) that limits natural keyword matching. It lands at the rubric midpoint on every dimension: serviceable within its ecosystem, but neither vague enough to fail nor concrete enough to stand out.

Suggestions

Add an explicit 'Use when...' clause with concrete trigger phrases, e.g. 'Use when the user asks for consensus planning, a Planner-Architect-Critic review, or a reviewed plan before execution.'

State what the stage actually produces (execution-ready plans, PRD/test-spec artifacts, Architect-Critic review evidence) so the 'what' is concrete rather than pipeline jargon.

Include natural synonyms such as 'plan review', 'architecture review', and 'planning handoff' so trigger matching does not rely solely on ecosystem-specific terms like $ultragoal.

DimensionReasoningScore

Specificity

The description names the domain ('Consensus planning stage') and the role pipeline ('Planner -> Architect -> Critic handoff to $ultragoal'), which is more than generic domain-naming (anchor 2) but stops short of the several concrete actions anchor 4 requires — it never says what the stage produces (execution-ready plans, PRD/test-spec artifacts, sequential review evidence).

3 / 5

Completeness

The 'what' is stated (a consensus planning stage feeding $ultragoal via a role pipeline), but there is no 'Use when...' clause or equivalent trigger guidance anywhere, so the rubric's completeness cap of 3 applies. It is above anchor 2 because the 'what' is not vague, and below anchor 4 because 'when' is entirely absent rather than weakly implied.

3 / 5

Trigger Term Quality

Terms like 'consensus planning', 'Planner', 'Architect', and 'Critic' are phrases an ecosystem user might naturally say, so it clears anchor 2; but common variations and synonyms ('plan review', 'design review', 'spec planning', 'task planning') are missing, which keeps it at anchor 3 rather than 4.

3 / 5

Distinctiveness Conflict Risk

The Planner->Architect->Critic pipeline and '$ultragoal' are distinctive markers within this ecosystem, but 'planning' alone is generic and the body itself acknowledges a closely related Plan skill ('Follow the Plan skill's full documentation for consensus mode details'), so overlap with similar planning skills remains plausible — anchor 3.

3 / 5

Total

12

/

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.