CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

executing-plans

Use when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available

Quality

74%

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

This is an exceptionally actionable process skill: exact commands, verbatim ledger formats, validation gates on every step, and explicit feedback loops for both task execution and the final fix pass. Its only real cost is token weight — the dot graph duplicates the prose workflow and several principles are restated multiple times across sections.

DimensionReasoningScore

Conciseness

The body is dense and prescriptive with almost no explanation of concepts Claude already knows, but the ~38-line dot digraph duplicates the prose Process/Task Loop sections, and key points repeat across sections ("a test you watched fail and then pass" reappears in the Process, the Task Loop, the completion contract, and the rationalizations table), so it is mostly efficient but could be tightened — anchor 3, not 2 because nearly every line is non-obvious guidance rather than padding, and not 4 because the graph/prose duplication is genuine token overhead.

3 / 5

Actionability

Fully executable guidance throughout: exact script invocations ("scripts/task-start PLAN_FILE N", "scripts/task-done PLAN_FILE N BASE -- <test command>", "review-package PLAN_FILE MERGE_BASE HEAD" with "MERGE_BASE = the commit the branch started from, e.g. git merge-base main HEAD") and verbatim ledger line formats ("Task <N>: complete (commits <base7>..<head7>, tests: <command> → <result>)") are copy-paste ready and cover the common cases — anchor 5.

5 / 5

Workflow Clarity

A clearly sequenced multi-step process (Setup → per-task loop → final review → fix pass → finish) with explicit validation checkpoints and feedback loops: every step's "Expected:" line is compared against real output with three defined outcomes, "A failing run records nothing; the task is not complete", a four-item completion contract with evidence, and a fix pass where "a suite that is not green after the pass means the pass is not over" — anchor 5.

5 / 5

Progressive Disclosure

Well-organized sections with clearly signaled one-level-deep references: this skill's scripts/task-start and scripts/task-done exist in the bundle and match their documented usage, and sibling-skill paths ("../subagent-driven-development/scripts/sdd-workspace", "../subagent-driven-development/scripts/review-package", "../requesting-code-review/code-reviewer.md") are each named with what they provide. The ~38-line dot graph and the 14-row rationalizations table are inline content that could live in reference files to keep the core loop lean, leaving minor organization gaps — anchor 4.

4 / 5

Total

17

/

20

Passed

Description

57%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, well-differentiated trigger clause that cleanly separates this skill from subagent-driven execution, but it is almost entirely a "when" statement: the "what" is a single thin action and the voice slips into second person ("yourself", "your human partner"), which the rubric penalizes. It would score solidly with a third-person rewrite that names the concrete mechanics the body actually delivers.

Suggestions

Rewrite in third person and enumerate 2-3 concrete actions, e.g. "Executes an implementation plan task-by-task in the current session: TDD per step, progress tracked in a ledger that survives compaction, rulings ledgered for every plan conflict, and one whole-branch review with a single verified fix pass."

Add natural trigger phrases users would actually say, such as "run the plan yourself", "execute the plan without subagents", or "follow this plan inline", alongside the existing jargon.

State the "what" as a separate declarative sentence before the "Use when" clause so the capability list is not buried inside the trigger condition.

DimensionReasoningScore

Specificity

"executing an implementation plan in the current session as the implementer yourself" names the domain and one core action but lists no other concrete capabilities (the ledger, TDD gating, and final review the body delivers are invisible), fitting anchor 3; the second-person phrasing ("as the implementer yourself", "your human partner chose inline execution") incurs the rubric's voice penalty, reducing it to 2.

2 / 5

Completeness

The "when" is explicit and concrete ("Use when executing an implementation plan... your human partner chose inline execution, or no subagent tool is available") and the "what" is present but thin ("executing an implementation plan... as the implementer yourself"); both are answered with one weaker, fitting anchor 4 rather than 5 because the "what" does not state what the process actually involves.

4 / 5

Trigger Term Quality

"executing an implementation plan", "inline execution", and "no subagent tool is available" are relevant terms, but "inline execution" is skill-family jargon rather than a phrase a user would naturally say, and common variations like "run the plan yourself", "follow the plan", or "implement the plan" are missing — matching anchor 3.

3 / 5

Distinctiveness Conflict Risk

The description carves a clear niche against subagent-driven execution ("as the implementer yourself — your human partner chose inline execution, or no subagent tool is available"), but the shared trigger phrase "executing an implementation plan" leaves minor overlap risk with closely related sibling plan-execution skills, matching anchor 4 rather than 5.

4 / 5

Total

13

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

obra/superpowers

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.