CtrlK
BlogDocsLog inGet started
Tessl Logo

executing-plans

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

51

Quality

55%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/executing-plans/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured orchestration skill with excellent workflow clarity and progressive disclosure. Its main weakness is moderate actionability — it describes what to do procedurally but lacks concrete examples of plan formats, TodoWrite invocations, or specific commands. The 'Remember' section is largely redundant with earlier content.

Suggestions

Add a concrete example of what a plan file looks like and how to load it (e.g., a sample TodoWrite call with task entries)

Remove or significantly trim the 'Remember' section since it mostly restates guidance already provided in the process steps and stop conditions

DimensionReasoningScore

Conciseness

Mostly efficient but has some redundancy — the 'Remember' section largely repeats guidance already given in the process steps and 'When to Stop' sections. The note about subagents is useful context but somewhat verbose.

2 / 3

Actionability

Provides a clear process with named steps and references to specific sub-skills, but lacks concrete examples — no sample plan format, no specific commands to load/read plans, no example of TodoWrite usage. The guidance is procedural but not copy-paste executable.

2 / 3

Workflow Clarity

The multi-step workflow is clearly sequenced (Load → Execute → Complete) with explicit validation checkpoints (run verifications, mark as completed), clear stop conditions, and feedback loops (stop when blocked, return to Step 1 when plan updates). The 'When to Stop' and 'When to Revisit' sections provide excellent error recovery guidance.

3 / 3

Progressive Disclosure

The skill appropriately serves as an orchestration overview, clearly referencing three related skills (using-git-worktrees, writing-plans, finishing-a-development-branch) with one-level-deep navigation. Content is well-organized into logical sections without being monolithic.

3 / 3

Total

10

/

12

Passed

Description

40%

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 focuses entirely on when to use the skill but fails to explain what the skill actually does. It lacks concrete actions, specific capabilities, and sufficient trigger terms. Without a 'what' component, Claude cannot meaningfully distinguish this skill's purpose from other execution-oriented skills.

Suggestions

Add concrete actions describing what the skill does, e.g., 'Executes multi-step implementation plans by breaking them into reviewable chunks, writing code, and pausing at checkpoints for user approval.'

Include natural trigger terms users might say, such as 'execute plan', 'implement step by step', 'run my plan', 'phased implementation', 'checkpoint-based coding'.

Expand the 'Use when' clause to clarify the scenario more precisely, e.g., 'Use when the user has a pre-written plan and wants to execute it incrementally across sessions with review gates between steps.'

DimensionReasoningScore

Specificity

The description contains no concrete actions—it doesn't say what the skill actually does (e.g., write code, generate files, refactor). 'Execute' and 'review checkpoints' are vague and abstract.

1 / 3

Completeness

The description provides a 'Use when...' clause addressing when to use it, but the 'what does this do' part is essentially absent—there is no explanation of what actions the skill performs.

2 / 3

Trigger Term Quality

Terms like 'implementation plan', 'separate session', and 'review checkpoints' are somewhat relevant but niche. Users are more likely to say things like 'execute my plan', 'run the next step', or 'continue implementation', which are not covered.

2 / 3

Distinctiveness Conflict Risk

The mention of 'implementation plan', 'separate session', and 'review checkpoints' provides some distinctiveness, but 'execute an implementation plan' is broad enough to overlap with general coding, task execution, or project management skills.

2 / 3

Total

7

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
lucianghinda/superpowers-ruby
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.