CtrlK
BlogDocsLog inGet started
Tessl Logo

executing-plans

Devflow wrapper for the upstream executing-plans skill. Use when you have a written implementation plan to execute task-by-task. ALWAYS invoke `/devflow:executing-plans` rather than the upstream skill directly — this wrapper guarantees that the post-implementation handoff goes to `/devflow:finish-feature` (devflow's verification + PR/MR creation flow) instead of `superpowers:finishing-a-development-branch` (the upstream default, which doesn't integrate with devflow's VCS-coherent finish flow).

70

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 well-engineered wrapper skill: every phase gives concrete, executable instructions, the risky worktree-recovery step is wrapped in explicit validation with a loud failure path, and the content stays focused on what Claude genuinely doesn't know about devflow. The only real improvements are trimming a few justificatory asides and possibly moving the Step 0 recovery script into a scripts/ bundle file.

DimensionReasoningScore

Conciseness

The body is dense with devflow-specific knowledge Claude cannot infer (spawn_task worktree forking, the finish-feature override, the changelog cache path), and the bash comments explain only non-obvious git subtleties. Minor over-explanation remains — "The implementation phase WRITES production code and commits it, so landing on the wrong branch is especially damaging" and the two-reasons preamble in the opening paragraph — which keeps it below the lean 5 anchor.

4 / 5

Actionability

The guidance is fully executable: a copy-paste-ready bash block with defined variables for worktree recovery (including the porcelain-parsing fallback for branch-already-checked-out), an exact fallback ladder for locating the upstream skill, verbatim user-facing messages to emit, and explicit "Invoke `/devflow:finish-feature` directly" instructions. Not below 4 because the common cases are covered with concrete commands rather than hints.

5 / 5

Workflow Clarity

The sequence (Step 0 → Phase 0 → Phase 1 → Phase 2) is explicit, and validation with feedback loops is present where it matters: Step 0 verifies the branch and fails loudly ("WORKTREE RECOVERY FAILED... exit 1") after attempting recovery, and Phase 0 walks a fallback chain rather than failing silently. No destructive or batch operation lacks validation, so no cap applies.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/ directories), and all content is appropriately inline for an ~85-line wrapper skill, organized under clear step/phase headers. It sits just outside the under-50-line simple-skill exception, and the Step 0 recovery bash block is long enough that it could arguably live in a scripts/ file, leaving minor organization gaps versus the 5 anchor.

4 / 5

Total

18

/

20

Passed

Description

82%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.

A strong, well-differentiated description that clearly states what the wrapper does and when to use it, with explicit disambiguation from the upstream superpowers skills. Its main weakness is voice: the second-person trigger clause and imperative invocation instruction trigger the rubric's specificity penalty, and a few natural trigger synonyms ("implement a plan", "follow a plan") are absent.

Suggestions

Rewrite the trigger clause in third person to avoid the specificity penalty, e.g. "Devflow wrapper for the upstream executing-plans skill, used when a written implementation plan must be executed task-by-task".

Add one or two natural trigger variations (e.g. "implementing a plan", "following a plan task-by-task") so users phrasing the need differently still match.

Trim the parenthetical explaining what the upstream default is ("which doesn't integrate with devflow's VCS-coherent finish flow") — the contrast with /devflow:finish-feature already carries the distinction.

DimensionReasoningScore

Specificity

The description lists several concrete actions ("Devflow wrapper for the upstream executing-plans skill", "guarantees that the post-implementation handoff goes to `/devflow:finish-feature`", "verification + PR/MR creation flow"), which on content alone fits the 4 anchor. However, the rubric mandates a 1-point specificity penalty for second-person voice, and the text uses "Use when you have a written implementation plan" and the imperative "ALWAYS invoke", so the score drops to 3.

3 / 5

Completeness

Both questions are explicitly answered: the what ("Devflow wrapper for the upstream executing-plans skill" that redirects the terminal handoff to the devflow finish flow) and the when ("Use when you have a written implementation plan to execute task-by-task") with a concrete trigger phrase. Not below 4 because the when-clause is explicit and specific rather than generic.

5 / 5

Trigger Term Quality

"written implementation plan" and "execute task-by-task" are natural phrases a user would say, giving good keyword coverage; common variations like "implement a plan", "follow a plan", or "work through the plan" are missing, keeping it below the 5 anchor's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche and actively disambiguates from the nearest competitors by name ("ALWAYS invoke `/devflow:executing-plans` rather than the upstream skill directly... instead of `superpowers:finishing-a-development-branch`"), so conflict risk with other plan-execution skills is minimal.

5 / 5

Total

17

/

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
AndreJorgeLopes/devflow
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.