CtrlK
BlogDocsLog inGet started
Tessl Logo

aw-create-plan

Create the plan artifact (plan.md + checks.yaml executable acceptance checks) in `.agent/{branch}/` from the current conversation context. Captures all Phase 0-1 discussion into a structured, self-contained document that enables context recovery and session handoff. On every invocation, writes plan.md and re-derives checks.yaml from the Acceptance Criteria; an immutable plan.vN.md snapshot is written only in opt-in snapshot mode (`Skill("aw-create-plan", "snapshot")`). Use after planning is complete and confidence gate passes — and again on every plan iteration (user-requested refinement or Phase 4 auto-replan). Triggers on create plan, generate plan, write plan artifact, regenerate plan, iterate on plan.

68

Quality

86%

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

81%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 unusually actionable, well-sequenced skill: executable commands, a complete artifact template, explicit validation checkpoints, and error-recovery guidance. Its main weakness is token efficiency — the snapshot-mode disambiguation and the checklist/failures overlap repeat the same information multiple times across ~470 lines.

Suggestions

State the snapshot-mode disambiguation once (in 'How the mode arg is read') and have Step 1 and the Validation Checklist reference it by anchor link instead of restating the rule.

Merge the Common Failures table into the Validation Checklist (or move it to a reference file) — roughly half its rows restate checklist items nearly verbatim.

Consider moving the Extended-tier 'Include when' commentary out of the inline template into a reference file, keeping only the trigger conditions inline, to shorten the monolithic body.

DimensionReasoningScore

Conciseness

The ~470-line body stays on skill-specific contracts with no generic padding, but the snapshot-mode disambiguation is stated three times (dedicated section, 'Resolve it before anything else', and again in Step 1), and the Validation Checklist and Common Failures tables restate the same failures. This is more than the 'minor instances' of the anchor above, so it sits at the mostly-efficient-could-be-tightened anchor.

3 / 5

Actionability

Fully executable guidance throughout: a runnable bash block for path/version resolution, a concrete checks.yaml example with real values ('curl -s -o /dev/null -w %{http_code} localhost:3000/me...'), a complete ready-to-fill plan template, and numbered authoring rules tied to specific validation rules. The placeholders are the deliberate artifact template, not pseudocode.

5 / 5

Workflow Clarity

Four clearly ordered steps with an explicit validation checkpoint ('After writing, verify against the checklist... If any item fails, fix the offending file(s) immediately'), a full post-write validation checklist, and a Common Failures table that serves as error-recovery feedback ('create rows but no Existing Code Survey → Run the reuse searches, add the section'). This matches the top anchor: explicit validation, feedback loops, and checklists.

5 / 5

Progressive Disclosure

No bundle files exist; the body is one well-sectioned document (Prerequisites / Procedure / Template / Validation Checklist / Common Failures) with clearly signaled, one-level-deep cross-skill references (e.g. phase-4-testing.md#executable-checks-loop). Good structure with minor gaps: the Extended-tier template commentary and duplicated failure guidance are long enough that a separate reference file would ease navigation, keeping it below the top anchor.

4 / 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: concrete, third-person, and comprehensive about what is written and when the skill should fire, with an explicit trigger list. The only gaps are a few missing natural trigger variations and slight genericness in the 'create plan' trigger that could overlap with general planning skills.

DimensionReasoningScore

Specificity

Multiple concrete actions with exact artifacts and paths ('Create the plan artifact (plan.md + checks.yaml executable acceptance checks) in `.agent/{branch}/`', 'writes plan.md and re-derives checks.yaml', 'an immutable plan.vN.md snapshot is written only in opt-in snapshot mode'), in third person throughout. Coverage of the skill's write behavior is comprehensive, matching the top anchor rather than the 'minor gaps' anchor below it.

5 / 5

Completeness

Explicitly answers both what ('Create the plan artifact... from the current conversation context') and when ('Use after planning is complete and confidence gate passes — and again on every plan iteration', plus a dedicated trigger list), matching the anchor requiring concrete trigger phrases for both.

5 / 5

Trigger Term Quality

'Triggers on create plan, generate plan, write plan artifact, regenerate plan, iterate on plan' gives good natural-phrase coverage, but common variations like 'update the plan' or 'plan document' are missing, so it does not reach the synonym-level breadth of the top anchor.

4 / 5

Distinctiveness Conflict Risk

The niche is pinned by specific artifacts (.agent/{branch}/plan.md, checks.yaml, plan.vN.md) and workflow phases ('Phase 4 auto-replan'), but generic triggers like 'create plan' carry minor overlap risk with general planning skills, keeping it below the minimal-conflict anchor.

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: 5 suspicious

Warning

Total

14

/

16

Passed

Repository
mthines/agent-skills
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.