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

67%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Critical

Do not install without reviewing

Fix and improve this skill with Tessl

tessl review fix ./skills/executing-plans/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%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 lean, well-structured orchestration skill with an explicit workflow, validation checkpoints, feedback loops, and clean delegation to sibling skills. Its main weakness is actionability: the critical-review and verification steps stay at the process level without concrete examples or criteria, leaving the model to improvise the most judgment-heavy parts.

Suggestions

Add 2-3 concrete examples of plan-review concerns (e.g., 'missing test steps', 'ambiguous acceptance criteria', 'tasks with no verification command') to make Step 1's critical review actionable.

Clarify the single-failure recovery path in Step 2 — e.g., 'If a verification fails: fix the issue and re-run it; stop and ask only after repeated failures' — since only the repeated-failure case is covered in the stop conditions.

Trim the 'Remember' section, which restates 'When to Stop and Ask for Help' and Steps 1-2, to remove duplicate tokens.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence ("Load plan, review critically, execute all tasks, report when complete"), matching 'Efficient; minor instances of over-explanation that could be trimmed' — the 'Remember' section duplicates content from 'When to Stop and Ask for Help' and Steps 1-2. It is not 5 because that redundancy means not every token earns its place.

4 / 5

Actionability

Steps are sequenced with some concrete specifics (verbatim announce phrases, "Create TodoWrite", "Mark as in_progress"), but key details are missing — 'Review critically - identify any questions or concerns' gives no examples of what to look for and 'Run verifications as specified' defers entirely to the plan, matching 'Some concrete guidance but incomplete'. Not 4 because there are no commands, examples, or concrete criteria for the review and verification steps.

3 / 5

Workflow Clarity

The process has a clear 3-step sequence with explicit validation ("Run verifications as specified"), feedback loops for error recovery (stop-and-ask on blockers, "Return to Review (Step 1) when: Partner updates the plan"), and a Remember checklist — matching anchor 5. Not 4 because the error-recovery paths (stop conditions, revisit loop) are explicitly spelled out rather than left implicit.

5 / 5

Progressive Disclosure

A clear one-line overview, well-organized sections, and well-signaled one-level-deep delegation to sibling skills (rubypowers:using-git-worktrees, rubypowers:finishing-a-development-branch) with nothing inlined that belongs elsewhere — matching 'Clear overview with well-signaled one-level-deep references'. No bundle files exist to verify, and none are needed for a skill of this size.

5 / 5

Total

17

/

20

Passed

Description

40%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, specific 'when' clause with a reasonably distinct trigger, but it completely omits the 'what' — no concrete actions or capabilities are stated. This makes it one-sided: strong on trigger guidance, weak on informing the model or user what the skill actually does.

Suggestions

Add a 'what' clause before the 'Use when' clause stating the concrete actions, e.g., "Loads a written implementation plan, reviews it critically, executes each task with verification, and reports results. Use when..."

Broaden trigger coverage with natural synonyms such as "implement", "follow", or "work through" an existing plan, and phrases like "execute the plan from writing-plans".

State the completion behavior (verify tests, finish the development branch via the finishing skill) so users know the full scope of what the skill does.

DimensionReasoningScore

Specificity

The description names the domain ("written implementation plan to execute in a separate session with review checkpoints") but lists no concrete capability actions, matching the anchor 'Names the domain but actions are minimal or generic'. It is not score 3 because that requires 1-2 concrete actions (e.g., 'loads a plan, executes tasks, verifies each step'), and not score 1 because it is not pure abstract language.

2 / 5

Completeness

The 'when' is explicit and specific ("Use when you have a written implementation plan to execute in a separate session"), but the 'what' is entirely absent — the description never states what the skill does, matching 'only when is present without what' (anchor 2). It cannot be 3 because that anchor requires a clear 'what'.

2 / 5

Trigger Term Quality

"implementation plan" and "execute" are natural phrases a user would say, matching 'Some relevant keywords but missing common variations or synonyms'. It falls short of 4 because coverage is thin — a single phrase cluster with no synonyms like 'implement', 'follow', or 'work through' the plan.

3 / 5

Distinctiveness Conflict Risk

"Execute a written implementation plan in a separate session" is a distinct trigger with a clear niche, matching 'Mostly distinct; minor overlap risk with closely related skills' — the sibling plan skills (writing-plans, subagent-driven-development) create minor overlap. Not 5 because a user saying 'here's a plan' could plausibly be routed to plan-writing or subagent-driven alternatives.

4 / 5

Total

11

/

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

lucianghinda/superpowers-ruby

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.