CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

implement-plan

Execute a reviewed implementation plan step by step with verification and standards review

Quality

75%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/implement-plan/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.

The body is an exceptionally well-specified orchestration workflow with copy-paste-ready dispatch prompts, exhaustive validation checkpoints and feedback loops, and real, clearly signaled one-level-deep references. Its only real weakness is conciseness: several inline design-rationale paragraphs duplicate material that the bundle's design-decisions.md exists to carry.

DimensionReasoningScore

Conciseness

The body is a dense operational procedure with no explanation of concepts Claude already knows, but it carries several inline rationale paragraphs (e.g. "That branch is the one place in this skill where an `ISSUES FOUND` is presented without asking the developer anything, so here is why..." and "because the prose handover still loses something") that duplicate the purpose of the existing references/design-decisions.md and could be moved there. Mostly efficient with some explanation that could be tightened matches this anchor better than the minor-trimming of a 4 or the padded sections of a 2.

3 / 5

Actionability

The guidance is fully executable: exact bash commands ("BASELINE_SHA=$(git rev-parse HEAD)", "CHANGED_FILES=$(git diff $BASELINE_SHA..HEAD --name-only)"), complete copy-paste Dispatch blocks with fully specified prompts, exact display strings, exact user questions ("Fix these issues, skip them, or stop implementation?"), enumerated exit-state handling, and a fallback for hosts without named agents. Placeholders like "{content of step N from the plan}" are inherent to orchestration and clearly marked, so there are no real gaps that would drop it to 4.

5 / 5

Workflow Clarity

The multi-phase sequence (validate/resolve → per-step implement/harden loop → fact check → relay/re-check → standards → final review → summary) is explicitly numbered with cross-referenced sections, tracked state variables ($PLAN_PATH, $BASELINE_SHA, $UNVERIFIED_FACTS, $RELAY_FACTS), validation checkpoints after every pass, feedback loops (ISSUES FOUND → fresh implementer → re-harden; corrections → relay implementer → targeted re-check), and explicit terminal branches. The summary checklist even mandates reporting unrun passes and a dirty working tree, which exceeds the anchor's requirements rather than showing minor gaps.

5 / 5

Progressive Disclosure

The bundle is real and well used: references/workflow.md (99 lines) and references/design-decisions.md (149 lines) are both actual files, referenced one level deep in a dedicated "## References" section with a one-line description of each, and the body itself is organized into clear sections (Host notes, Objective, Context, numbered phases). The gap keeping it from 5 is that the design rationale inlined in the body belongs in the already-present design-decisions.md, so content placement is not fully appropriate.

4 / 5

Total

17

/

20

Passed

Description

58%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 gives a clear, moderately specific statement of what the skill does in third person, but it completely lacks trigger guidance. Without a "Use when..." clause or natural trigger phrases, completeness and trigger-term quality are held to the midpoint.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to implement, execute, or carry out a reviewed plan from plans/".

Include natural trigger variations users would actually say ("implement the plan", "run the plan", "build the plan") to broaden keyword coverage.

Mention the fact-check and final-review passes to close the coverage gap in the action list (e.g. "...followed by a fact check against live sources and a final review").

DimensionReasoningScore

Specificity

"Execute a reviewed implementation plan step by step with verification and standards review" names three domain-specific actions (step-by-step execution, verification, standards review), matching the anchor for several specific actions with minor gaps. It is not comprehensive: the body's core passes (per-step hardening, fact check against live sources, final review, summary) are absent from the description.

4 / 5

Completeness

The "what" is clear (execute a reviewed plan step by step with verification and standards review), but there is no "Use when..." clause or equivalent explicit trigger guidance, capping completeness at 3 per the judging guidelines. The "when" is only weakly implied by "reviewed implementation plan", so it cannot score 4.

3 / 5

Trigger Term Quality

"implementation plan", "execute", and "standards review" are relevant keywords a user might use, but common natural variations are missing ("run the plan", "build the plan", "follow the plan", "carry out the plan"). Some relevant keywords with missing variations matches the anchor, and it lacks the good coverage needed for a 4.

3 / 5

Distinctiveness Conflict Risk

"Execute a reviewed implementation plan step by step" carves a mostly distinct niche (implementing an already-reviewed plan file) with only minor overlap risk against closely related skills (plan-writing, code-review, or generic implementation skills). The generic tail "with verification and standards review" broadens it slightly, keeping it below a 5 with truly distinct triggers.

4 / 5

Total

14

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

phatblat/dotfiles

Path

.agents/skills/implement-plan/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.