CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

planning

To build execution-ready plans from approved intent/specs with EARS, sequenced WBS, and HITL checkpoints.

Quality

70%

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 ./instructions/r2/core/skills/planning/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 disciplined, dense instruction set with a clear core flow, explicit validation gates, and a full checklist, externalizing heavy templates appropriately. It falls short of top marks mainly on missing worked examples of its output artifacts (an EARS requirement, a WBS step) and on small reference-hygiene issues in the bundle.

Suggestions

Add one compact worked example — a single EARS requirement and one filled-in WBS step showing all required fields — so the output format is copy-paste unambiguous rather than implied by the field list.

Make the validation_checklist a feedback loop: state which core-flow step to revisit when a checklist item fails, and that re-validation continues until all items pass.

Fix the template paths to match the bundle layout (assets/pl-wbs.md, not planning/assets/pl-wbs.md), add a one-line purpose per template, and either reference or remove the orphaned assets/pl-validation-rubric.md.

DimensionReasoningScore

Conciseness

The body is dense and assumes competence — no padding and no explanation of concepts Claude already knows; every section carries rules. It falls just short of anchor 5 because of minor redundancy: the WBS contract ("Define WHAT, WHEN, WHO, WHERE per step") repeats the enforce section's meta-sequence, and the pitfalls/best-practices lists restate validation_checklist items, so a small amount could be trimmed or merged.

4 / 5

Actionability

For an instruction-only skill the guidance is largely concrete: a numbered 7-step core flow, an explicit per-step field contract ("title, description, agent, AC, NFR, EARS FR, priority, predecessors"), a request-size scaling table, and named template paths to acquire. It stops short of anchor 5 because there is no worked example of an EARS requirement or a filled-in WBS step, which is the common case for a skill whose entire output is those artifacts.

4 / 5

Workflow Clarity

The core flow is a clearly numbered sequence with explicit checkpoints: "Close gaps and consistency issues", "Stop and escalate when critical unknowns block safe planning", HITL approval gates, and a 13-item validation_checklist. It misses anchor 5 because the checklist is a final gate rather than an embedded validate-then-retry feedback loop — the flow doesn't state what to do when a checklist item fails (e.g., revisit which step and re-verify).

4 / 5

Progressive Disclosure

Structure is good: the main body holds rules and the LARGE-only templates are externalized to three real asset files (verified to exist in ./assets/), referenced one level deep via a dedicated templates section. Minor gaps keep it below 5: the referenced paths ('planning/assets/pl-wbs.md') don't match the actual bundle layout (assets/pl-wbs.md), templates are listed without a word on what each contains, and assets/pl-validation-rubric.md is present but never referenced from the body.

4 / 5

Total

16

/

20

Passed

Description

53%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 concise and identifies its niche, but it reads as a compressed domain statement rather than a triggerable description: the 'what' is present while the 'when' is entirely absent, and the jargon-heavy phrasing (EARS, HITL) lacks the natural terms users would say when they need this skill.

Suggestions

Add an explicit 'Use when...' clause (e.g., 'Use when a tech spec is approved and an execution plan is needed, or when a complex request must be decomposed into a sequenced task plan') to answer 'when should this be used' — completeness is capped at 3 without one.

Include natural trigger phrases users would actually say — 'create a project plan', 'break this request down into tasks', 'sequence the work', 'work breakdown structure' — alongside the technical terms to improve trigger-term quality.

Spell out or supplement the acronyms (EARS requirements, human-in-the-loop checkpoints) so the description is distinguishable and comprehensible to users who don't already know the methodology jargon.

DimensionReasoningScore

Specificity

The description names its domain and one concrete action — "To build execution-ready plans from approved intent/specs" — plus named artifacts ("EARS", "sequenced WBS", "HITL checkpoints"), but these are artifact nouns rather than a list of several specific actions. It matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) better than anchor 4, which expects several distinct specific actions listed.

3 / 5

Completeness

The "what" is clear — building execution-ready plans from approved intent/specs — but there is no "Use when..." clause or equivalent trigger guidance anywhere in the description, which caps completeness at 3 per the judging guidelines. This matches anchor 3 (clear 'what', 'when' missing) and rules out anchor 4, which requires both present.

3 / 5

Trigger Term Quality

Relevant keywords like "execution-ready plans", "tech spec", and "WBS" exist, but the heavy reliance on specialized jargon ("EARS", "HITL") crowds out natural phrases a user would actually say ("break this down into tasks", "create a project plan", "sequence the work"). This fits anchor 3 — some relevant keywords but missing common variations and synonyms — rather than anchor 4's broader natural-term coverage.

3 / 5

Distinctiveness Conflict Risk

The EARS/WBS/HITL framing carves out a fairly distinct planning niche with minimal conflict risk against unrelated skills, matching anchor 4 (mostly distinct, minor overlap risk). It is not a 5 because "planning" broadly overlaps with closely related architecture/decomposition skills and no trigger phrasing further separates them.

4 / 5

Total

13

/

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

griddynamics/rosetta

Path

instructions/r2/core/skills/planning/SKILL.md

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.