CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

executing-plans

Use when you have a written implementation plan to execute in a separate session with review checkpoints

1.69x
Quality

70%

Does it follow best practices?

Impact

44%

1.69x

Average score across 8 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/executing-plans/SKILL.md

The canonical home for this skill is executing-plans in obra/superpowers

SKILL.md
Quality
Evals
Security

Quality

Content

71%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 tight, well-structured process skill with concrete, actionable instructions and clear sequencing, validation checkpoints, and integration with related skills. Its main weaknesses are redundant repetition of the stop-and-ask guidance and an implicit (rather than explicit) fix-and-retry loop for failed verifications.

Suggestions

Collapse the 'Remember' and 'When to Revisit Earlier Steps' sections into 'When to Stop and Ask for Help' — most of their lines restate points already made there.

Add an explicit recovery step for a single failed verification (e.g., 'Investigate the failure, fix, and re-run the verification; if it fails twice, stop and ask') before the stop condition triggers.

DimensionReasoningScore

Conciseness

The body is mostly lean and assumes Claude's competence (no concept explanations, terse step lists), but there is real duplication: "Review plan critically first", "Stop when blocked, don't guess", and "Don't force through blockers - stop and ask" restate guidance already fully covered in 'Step 1' and 'When to Stop and Ask for Help'. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened'; not level 4 because the 'Remember' section is almost entirely redundant, not a minor trim.

3 / 5

Actionability

For an instruction-only process skill the guidance is concrete: exact announcement strings ("I'm using the executing-plans skill to implement this plan."), named sub-skills (superpowers:using-git-worktrees, finishing-a-development-branch), and a concrete per-task cycle (mark in_progress, follow steps, run verifications, mark completed). Minor gaps keep it below 5: it never says where the plan file lives, how to chunk TodoWrite items, or what to do when a verification fails once (vs. repeatedly).

4 / 5

Workflow Clarity

The three-phase sequence (Load and Review → Execute Tasks → Complete Development) is clear with most checkpoints present: critical review before starting, per-task verification, explicit stop conditions, and a 'when to revisit' loop. Below 5 because the error-recovery loop is only implicit — a single failed verification has no fix-and-retry guidance, only 'verification fails repeatedly' triggers stopping.

4 / 5

Progressive Disclosure

The skill is self-contained (~65 lines) with well-organized sections and no content that belongs in separate files; its only external references are named workflow skills, clearly signaled one level deep in the Integration section with role labels. This matches 'well-organized sections' ideal for a reference-free skill, with no nested or buried references.

5 / 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 has an explicit, natural 'Use when...' trigger and a distinct niche, but it never states what the skill actually does as a capability — the 'what' is only implied inside the when-clause, and trigger vocabulary is narrow. Restructuring to lead with the capability (e.g., 'Executes a written implementation plan task-by-task with verification and review checkpoints') would raise both specificity and completeness.

Suggestions

State the 'what' as an explicit third-person capability before the trigger, e.g., 'Executes a written implementation plan task-by-task in a separate session, running verifications and pausing at review checkpoints. Use when you have a completed plan to implement.'

Broaden trigger vocabulary with natural synonyms users would say — 'follow the plan', 'carry out this plan', 'implement the plan' — alongside 'execute'.

Include the concrete actions the skill performs (review plan critically, execute tasks with verification, complete the development branch) so specificity rises beyond one embedded action.

DimensionReasoningScore

Specificity

The description names the domain ("written implementation plan") with 1-2 concrete actions ("to execute", "review checkpoints") but no broader action coverage, matching the domain-plus-1-2-actions anchor. It is above level 2 ('Processes PDF files' — domain with only a generic action) because 'execute...with review checkpoints' adds concrete substance, and below level 4 because it does not list several specific actions.

3 / 5

Completeness

The 'when' is explicit and strong ("Use when you have a written implementation plan to execute in a separate session"), but the 'what' is only embedded in the when-clause rather than stated as a capability — no separate statement of what the skill does (e.g., 'Loads the plan, executes tasks, verifies completion'). This falls between anchor 2 (only 'when' present, e.g., 'Use when working with documents') and anchor 3; it edges toward 3 because 'to execute...with review checkpoints' does convey the core action, but cannot reach 4 where both what and when are explicitly and separately stated.

3 / 5

Trigger Term Quality

Relevant natural keywords are present ("implementation plan", "execute", "review checkpoints") but common variations users would say are missing ("follow the plan", "carry out", "run the plan"), matching the 'some relevant keywords but missing variations' anchor. It is below level 4's 'good keyword coverage' because the trigger vocabulary is narrow, and above level 2 because the terms are domain-specific rather than generic.

3 / 5

Distinctiveness Conflict Risk

"written implementation plan", "in a separate session", and "review checkpoints" carve a mostly distinct niche with minor overlap risk against closely related skills (e.g., plan-writing or generic implementation skills). It is not level 5 because a user asking to 'implement this plan' without the separate-session/checkpoint framing could still match other skills, and clearly above level 3's 'could still overlap with similar skills'.

4 / 5

Total

13

/

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

valeriibeck-star/claude-skills

Path

skills/executing-plans/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.