CtrlK
BlogDocsLog inGet started
Tessl Logo

ce-plan

Create structured plans for multi-step work, including software and non-software tasks. Use when asked to plan, break down implementation, plan from requirements, or deepen an existing plan; prefer ce-brainstorm for exploratory framing.

65

Quality

79%

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

The canonical home for this skill is ce-plan in EveryInc/compound-engineering-plugin

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.

A well-engineered orchestration body: lean rule-dense prose, precise routing into per-phase references that all exist, and explicit error-recovery behavior. It uniformly falls just short of the top anchors because the completion-contract policy is inlined rather than split out, and the validation steps it names are only defined in references.

Suggestions

Move the Mandatory Completion Contract paragraph (and its per-tier detail) into a reference such as plan-handoff.md or output-contracts.md, leaving a one-line completion rule in the body — this would reduce both the conciseness redundancy with step 10 and the body's inline policy weight.

Replace the bare "The current year is 2026" line with a non-time-sensitive formulation (or relocate it to a reference that handles staleness), since time-sensitive content outside a deprecated/old-patterns section penalizes conciseness.

In the Output Contract section, either inline the one-sentence tier decision tests or point explicitly at the section of output-contracts.md that holds them, so the tier choice is fully actionable without first opening a reference.

DimensionReasoningScore

Conciseness

The body is dense with zero padding and no explanation of concepts Claude already knows — every line is a behavioral rule. Not 5 because of minor trimmable material: the bare "The current year is 2026" line is time-sensitive information outside any deprecated-patterns section, and the Mandatory Completion Contract paragraph restates handoff/menu rules that step 10 repeats. Not 3 because there is no unnecessary explanation, only mild redundancy.

4 / 5

Actionability

Concrete, executable directives dominate: exact question text ("Plan ready at `<absolute path to plan>`. What would you like to do next?"), an exact return token (`settled-decision-invalidated`), and enumerated blocked-status fields (`status`, `phase`, `blocker`, `recovery_path`). Not 5 because most operational detail (tier definitions, phase sub-steps) is only named, not given — a reader must open references to act; not 3 because what is inlined is specific and executable, with only minor gaps.

4 / 5

Workflow Clarity

Phases are explicitly ordered (0 through 5) with gating ("Do not pass a decision point that has not resolved"), STOP markers before risky steps, and real error-recovery loops (unreadable reference → stop and report blocker + recovery path; invalidated decision → stop and return the token). Not 5 because the validation checkpoints themselves (confidence mode, ce-doc-review, Phase 5.4 mechanics) are deferred to references rather than stated in the body's sequence; not 3 because the sequence and recovery paths are explicit, not implicit.

4 / 5

Progressive Disclosure

Checked against the actual bundle: all ten references named in the body (output-mode, resume, intake, research, structure, plan-sections, final-review, reasoning-elevation, plan-handoff, output-contracts) exist in references/, each read is bound to a specific phase, and references are one level deep with clear signals. Not 5 because the body inlines dense policy (the Mandatory Completion Contract section, tier rules) that belongs in a reference, keeping the overview heavier than the anchor ideal; not 3 because organization and navigation are otherwise clear.

4 / 5

Total

16

/

20

Passed

Description

83%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.

A strong description: concrete actions, an explicit 'Use when' trigger list, and explicit disambiguation from adjacent ce-* skills. The only weaknesses are slightly thinner coverage of natural trigger synonyms and the inherent breadth of the word 'plan'.

DimensionReasoningScore

Specificity

Quotes several concrete actions — "Create structured plans", "break down implementation", "plan from requirements", "deepen an existing plan" — with minor coverage gaps (it never says what a plan contains or how it is delivered). Not 5 because coverage of the planning domain stops at the action list; not 3 because more than 1-2 specific actions are named across both software and non-software work.

4 / 5

Completeness

Explicitly answers both: what ("Create structured plans for multi-step work, including software and non-software tasks") and when ("Use when asked to plan, break down implementation, plan from requirements, or deepen an existing plan"). This matches the anchor-5 pattern of a clear what plus a concrete 'Use when' trigger list; a 4 would require the 'when' clause to be less explicit than it is.

5 / 5

Trigger Term Quality

Natural user phrases are present: "asked to plan", "break down implementation", "plan from requirements", "deepen an existing plan". Not 5 because common variations such as "requirements doc", "implementation plan", "roadmap", or "task breakdown" are missing; not 3 because the included terms are the phrases a user would naturally say, not jargon.

4 / 5

Distinctiveness Conflict Risk

The niche is defined and disambiguated against siblings ("prefer ce-brainstorm for exploratory framing"), and triggers are planning-specific. Not 5 because "plan" is a broadly overlapping word that could collide with generic planning skills absent the ce-* family context; not 3 because explicit routing guidance keeps conflict risk minor.

4 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
crdant/compound-engineering-plugin
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.