CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aw-create-plan

Writes the plan artifact in `.agent/{branch}/` — `plan.md` as a brief (task, guardrails, definition of done, turn cap, file changes) plus `checks.yaml`, its executable acceptance checks, sealed for `run-checks.mjs`. Use after planning and on every plan iteration; triggers on create plan, write plan artifact, regenerate plan, iterate on plan.

Quality

88%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exceptionally actionable, well-sequenced skill body: exact commands, complete templates, explicit validation with feedback loops, and no filler. Its weaknesses are redundancy around the sealing procedure and unresolvable `rules/` references plus opaque parent-skill rule citations.

Suggestions

Ship `rules/snapshot-mode.md` and `rules/extended-sections.md` in the bundle (or inline their short rules) — two of the three referenced paths currently resolve nowhere.

Consolidate the `--seal` guidance, which currently appears in Procedure step 3, the Validation checklist, and two Common-failures rows.

Link or inline the `confidence(plan)` rules cited by number (rule #9, #11, rule 4) so the constraints are resolvable outside the parent `autonomous-workflow` skill.

DimensionReasoningScore

Conciseness

The body is dense, imperative, and free of explanations of concepts Claude already knows — every line carries a rule, command, or template. Not 5: there is real redundancy, e.g. the `--seal` guidance appears in Procedure step 3, the Validation checklist, and two rows of Common failures, and the unexplained `confidence(plan)` rule citations ("rule #9", "rule #11", "rule 4") add lookup overhead.

4 / 5

Actionability

Fully executable throughout: copy-paste bash for path resolution and sealing ("node .../run-checks.mjs \"${DIR}/checks.yaml\" --seal"), a complete plan.md template, a complete checks.yaml schema with every field, validation greps with expected outputs ("must print 6"), and an error-to-fix table. Not 4: commands are exact and the common cases (sealing, telemetry ACs, placeholder mistakes) are all covered with contrastive right/wrong examples.

5 / 5

Workflow Clarity

Prerequisites are listed, the Procedure is a clean Steps 1–4, and Step 4 routes through a Validation section with an explicit feedback loop ("fix every failure before returning"), executable checks, a checklist, and a Common failures recovery table. Not 4: checkpoints are explicit and recovery paths are tabulated, satisfying the anchor's checklist and feedback-loop requirements.

5 / 5

Progressive Disclosure

The overview is well structured with a Contents list and `references/brief-rationale.md` exists, is one level deep, and is clearly signaled ("**Why:** [`references/brief-rationale.md`](...)"). However, two of the three paths referenced in the body — `rules/snapshot-mode.md` and `rules/extended-sections.md` — are absent from the bundle, so navigation breaks exactly at the points the skill says "read when the arg is exactly `snapshot`". Not 4: two dangling reference links out of three is more than a minor organization gap.

3 / 5

Total

17

/

20

Passed

Description

88%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: third-person, concrete about what is written and where, and explicit about when to use it with literal trigger phrases. The only weaknesses are a trigger list that is repetitive and narrow around the word "plan", and a slightly generic "create plan" trigger that could overlap general planning requests.

DimensionReasoningScore

Specificity

The description names the exact artifacts and their contents — "Writes the plan artifact in `.agent/{branch}/` — `plan.md` as a brief (task, guardrails, definition of done, turn cap, file changes) plus `checks.yaml`, its executable acceptance checks, sealed for `run-checks.mjs`" — matching the anchor for multiple specific concrete actions with comprehensive coverage. Not 4: there are no coverage gaps; files, their sections, and the sealing operation are all enumerated.

5 / 5

Completeness

Both questions are answered explicitly: the "what" is concrete (write plan.md as a brief plus checks.yaml, sealed for run-checks.mjs) and the "when" carries explicit trigger phrases ("Use after planning and on every plan iteration; triggers on create plan, write plan artifact, regenerate plan, iterate on plan"). Not 4: the "when" is explicit and specific rather than merely present with room to improve.

5 / 5

Trigger Term Quality

"triggers on create plan, write plan artifact, regenerate plan, iterate on plan" plus "Use after planning" gives good natural keyword coverage. Not 5: the terms are narrow and repetitive around the single word "plan" and miss common synonyms a user would naturally say ("update the plan", "revise plan", "new plan"). Not 3: the phrases given are natural user phrasings, not just technical jargon.

4 / 5

Distinctiveness Conflict Risk

The artifact names (`.agent/{branch}/`, `checks.yaml`, `run-checks.mjs`) carve out a distinct niche, but bare trigger phrases like "create plan" could also fire for ordinary planning requests, giving minor overlap risk with closely related planning skills. Not 5: the generic trigger "create plan" is not uniquely tied to this skill.

4 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 2 missing

Warning

Total

14

/

16

Passed

Repository

mthines/agent-skills

Path

skills/workflow/aw-create-plan/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.