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

65%

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 ./.claude/skills/executing-plans/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 maximally lean redirect stub: perfectly concise and unambiguous about its single action, but it carries no substantive guidance of its own. Its sole reference is an external absolute path that cannot be verified from the bundle, which caps both actionability and progressive disclosure.

DimensionReasoningScore

Conciseness

The body is two lines: a generator comment ("Generated by scripts/agent-harnesses.py; do not edit directly.") that serves a real maintenance function, and one instruction. Every token earns its place and the skill fully assumes Claude's competence.

5 / 5

Actionability

"Load and follow the shared skill at `~/.agents/skills/executing-plans/SKILL.md`" is a concrete, unambiguous, executable directive. It falls short of 5 because all substantive guidance is delegated to an external absolute path that does not exist in this bundle or environment, leaving no fallback content.

4 / 5

Workflow Clarity

The single action is unambiguous, satisfying the simple-skill exception, but the workflow the description advertises ("review checkpoints") is entirely outsourced to the external file — no checkpoints or error handling (e.g., what to do if the target is missing) appear here. Not 3, since nothing about the one step is vague or implicit.

4 / 5

Progressive Disclosure

The single reference is clearly signaled and one level deep, but it points outside the skill bundle to an absolute home-directory path (`~/.agents/...`) that does not resolve in this environment, with no references/ directory or local fallback. Structure cannot be verified and navigation depends on machine state, which is more than 'minor organization gaps' (anchor 4).

3 / 5

Total

16

/

20

Passed

Description

36%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 is a pure trigger clause: it says when to invoke the skill but never says what the skill does. The trigger conditions themselves are reasonably specific and natural, but missing action verbs, missing synonyms, and the absent 'what' half leave it below the midpoint overall.

Suggestions

Add a 'what' clause naming 1-3 concrete actions, e.g., "Loads a written implementation plan, executes it step by step in a fresh session, and pauses at review checkpoints for user feedback. Use when..."

Broaden trigger coverage with natural synonyms users would actually say, such as "follow the plan", "carry out", "work through", or "plan.md".

State the skill's distinguishing behavior (checkpoint-driven execution) up front to reduce overlap with plan-writing or general task-execution skills.

DimensionReasoningScore

Specificity

The description names the domain ("execute in a separate session with review checkpoints") but lists no concrete actions the skill performs — there is no 'what' at all. It is above the purely abstract anchor (1) because the domain is identifiable, but below anchor 3, which requires 1-2 concrete actions.

2 / 5

Completeness

Only the 'when' is present ("Use when you have a written implementation plan...") with no 'what' — the skill's actual behavior is never stated. This exactly matches anchor 2 ("only 'when' is present without 'what'"), and cannot be 3 because even a weak 'what' is absent.

2 / 5

Trigger Term Quality

Phrases like "written implementation plan", "execute", and "separate session" are relevant, but common natural variations are missing (e.g., "follow the plan", "carry out", "work through the plan", "plan.md"). Not 4, since anchor 4 requires good keyword coverage with only a few natural terms missing.

3 / 5

Distinctiveness Conflict Risk

The trigger conditions (written plan, separate session, review checkpoints) are somewhat specific, but the description could still overlap with plan-creation or general task-execution skills. Without a 'what' clause, it is harder to distinguish from closely related skills, so it does not reach anchor 4.

3 / 5

Total

10

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

phatblat/dotfiles

Path

.claude/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.