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

Quality

66%

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 ./src-tauri/experts/skills/executing-plans/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

67%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 well-structured, actionable process skill with a clear three-step workflow, explicit checkpoints, and appropriate single-file organization. Its main weakness is repetition — the stop-and-ask message and critical-review reminder each appear multiple times — which inflates token cost without adding guidance.

Suggestions

Consolidate the stop-and-ask guidance into the 'When to Stop and Ask for Help' section and remove the duplicated lines from 'Remember' and 'When to Revisit Earlier Steps'.

Trim the subagent/platform note to a single sentence (e.g. 'If subagents are available, prefer superpowers:subagent-driven-development instead.') and cut 'Review plan critically first' from Remember since Step 1 already mandates it.

Add one concrete recovery step for verification failure (e.g. what to check or retry once before stopping) so 'Run verifications as specified' has a complete feedback loop.

DimensionReasoningScore

Conciseness

The body is mostly efficient bullets, but the stop-and-ask guidance is repeated three times ('Ask for clarification rather than guessing', "Don't force through blockers - stop and ask", 'Stop when blocked, don't guess'), 'Review plan critically first' in Remember duplicates Step 1, and the platform note about Superpowers working 'much better with access to subagents' is padded — matching 'mostly efficient but could be tightened'.

3 / 5

Actionability

For an instruction-only skill the guidance is concrete: verbatim announce strings, named sub-skills ('superpowers:finishing-a-development-branch', 'superpowers:using-git-worktrees'), explicit tool actions ('Create TodoWrite', 'Mark as in_progress'), and a specific stop-condition list. Minor gaps remain — 'Run verifications as specified' defers entirely to the plan without saying what to do on first failure.

4 / 5

Workflow Clarity

The three-step sequence is clear with real checkpoints: a concern gate before starting ('If concerns: Raise them with your human partner before starting'), per-task verification ('Run verifications as specified'), explicit stop conditions, revisit conditions, and a Remember checklist. Error recovery escalates ('Verification fails repeatedly' → stop and ask) rather than giving a fix-and-retry loop, and completion is delegated to a sub-skill, leaving minor validation gaps.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so everything lives appropriately in a single well-sectioned SKILL.md, with cross-skill references clearly signaled one level deep in the Integration section. The redundancy between 'When to Stop', 'When to Revisit', and 'Remember' is a minor organization gap keeping it below the top anchor.

4 / 5

Total

15

/

20

Passed

Description

48%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 a clear, explicit trigger and a distinct niche, but it functions almost entirely as a 'when' clause: it never states what the skill actually does, uses second-person phrasing, and lacks trigger synonyms. Adding a third-person capability statement ('Executes implementation plans task-by-task, runs verifications, reports results') would lift both completeness and specificity.

Suggestions

Lead with a third-person capability statement, e.g. 'Executes a written implementation plan task-by-task in a fresh session: loads the plan, reviews it critically, runs each task's verifications, and reports completion with review checkpoints.'

Add natural trigger synonyms users would say, such as 'implement the plan', 'follow the plan', or 'work through the plan', alongside 'execute'.

Drop the second-person construction ('Use when you have...') in favor of 'Use when executing a written implementation plan...' to match the third-person voice convention.

DimensionReasoningScore

Specificity

The description names the domain ('a written implementation plan to execute') with essentially one generic action ('execute'), listing no concrete capabilities such as running verifications or reporting. It is also phrased in the second person ('Use when you have a written implementation plan'), which per the guidelines reduces the specificity score by 1 from an anchor-3 base.

2 / 5

Completeness

The 'when' is explicit ('Use when you have a written implementation plan to execute in a separate session with review checkpoints'), but the 'what' is only weakly implied by the embedded phrase 'to execute' — no capability statement like 'executes each task, runs verifications, and reports results' appears. This sits between 'only when present without what' (2) and 'both present, when could be more specific' (4).

3 / 5

Trigger Term Quality

Relevant keywords are present ('written implementation plan', 'execute', 'separate session', 'review checkpoints') but common variations users would naturally say — 'implement the plan', 'follow the plan', 'work through the plan', 'run the plan' — are missing, matching the anchor for some relevant keywords without synonyms.

3 / 5

Distinctiveness Conflict Risk

The niche is clear — executing an already-written plan in a fresh session — and distinct from plan-writing or ad-hoc implementation, so it would not trigger for the wrong skill in most cases. Minor overlap risk remains with closely related workflow skills (e.g., subagent-driven development or plan-writing), matching the 'mostly distinct' anchor.

4 / 5

Total

12

/

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

arwei944/codeg

Path

src-tauri/experts/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.