CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

implementation-approach

Implementation strategy selection framework. Use when planning implementation strategy, selecting development approach, or defining verification criteria.

Quality

63%

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/implementation-approach/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%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 skill presents a coherent, well-sequenced seven-phase decision framework with explicit stop conditions, a re-test loop, and a closing quality checklist — genuinely strong workflow clarity. Its weaknesses are prose density that demands multiple reads, guidance that remains abstract policy without a worked example, and a monolithic single-file layout (including a dangling external reference) where a split structure would help. Tightening the language and adding one concrete worked example would raise the two heaviest-weighted dimensions.

Suggestions

Add a short worked example (a small before/after scenario showing one condition triggering the subtraction check and a chosen L-level) to ground the abstract Phase 2 and Phase 6 decision rules.

Move the reference pattern catalog, verification-level definitions, and integration-point definitions into a references/ file, and fix or remove the dangling 'coding-principles Reference Representativeness' mention on line 27.

Compress the near-duplicate Phase 4/Phase 5 skeletons and the 'Guidelines for Meta-cognitive Execution' section (which restates phase rules) into a single conditional-checks section to cut redundant tokens.

DimensionReasoningScore

Conciseness

The body never explains concepts Claude already knows, so there is no classic filler, but it could be tightened significantly: Phases 4 and 5 are near-duplicate skeletons, the 'Guidelines for Meta-cognitive Execution' section restates rules already given in the phases, and sentences like the ~90-word Phase 2 step 3 ('Compare viable choices by total complexity across the dimensions that materially differ: user decisions, settings, modes, concepts, outputs...') are baroque. This lands on 'mostly efficient but could be tightened' rather than the 'noticeably verbose' anchor, since the density comes from phrasing, not unnecessary explanations.

3 / 5

Actionability

Concrete elements exist — the four numbered Phase 2 steps, named patterns with explicit application conditions, L1/L2/L3 verification definitions, and the subtraction-check procedure — but the guidance stays at the level of abstract decision policy with no worked example or concrete artifact showing the framework applied. As an instruction-only skill it matches 'some concrete guidance but incomplete; missing key details' better than the 'mostly executable' anchor.

3 / 5

Workflow Clarity

The seven phases are clearly sequenced, Phase 1 has an explicit stop condition ('Stop when the current-state facts that could change responsibility, reuse, option validity... have been checked'), the subtraction check provides a re-test loop, and the Quality Checks section is an end-of-process checklist. It falls short of anchor 5 because validation is a post-hoc checklist rather than inline feedback loops with error-recovery steps at each phase.

4 / 5

Progressive Disclosure

Sections are well-organized with clear headers, but at ~157 lines with no bundle files, content such as the reference pattern catalog (Strangler/Facade/Adapter/etc.) and the L1/L2/L3 and integration-point definitions are natural candidates for separate reference files. Additionally, line 27's 'find existing code as coding-principles Reference Representativeness describes' is a dangling reference to material not present in the bundle, matching 'references present but not clearly signaled.'

3 / 5

Total

13

/

20

Passed

Description

53%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 and well-formed 'Use when...' clause with three concrete trigger phrases, which anchors its completeness at a good level. However, the 'what' half is vague ('selection framework' names a domain, not a capability), the trigger vocabulary lacks synonyms and variations, and the abstract phrasing invites overlap with general planning skills. Tightening the what-statement into concrete actions would lift specificity and distinctiveness together.

Suggestions

Replace the vague 'Implementation strategy selection framework' with concrete actions, e.g., 'Selects an implementation approach (vertical slice, horizontal slice, or hybrid) and defines verification levels (L1/L2/L3) for a planned change.'

Add natural trigger variations users would actually say, such as 'choosing an approach,' 'implementation plan,' 'refactor vs. rewrite,' or 'how to break up this change,' to broaden trigger-term coverage.

Sharpen distinctiveness by naming what makes this skill different from generic planning, e.g., anchoring triggers on 'deciding between vertical and horizontal implementation' or 'defining verification criteria for a strategy.'

DimensionReasoningScore

Specificity

"Implementation strategy selection framework" names the domain, but the only actions offered ("planning implementation strategy, selecting development approach, or defining verification criteria") are generic and largely restate the domain rather than enumerating concrete capabilities. It matches the anchor 'names the domain but actions are minimal or generic' better than anchor 3, since only 'defining verification criteria' is a distinct action and it remains abstract.

2 / 5

Completeness

Both what and when are present: "Implementation strategy selection framework" states what it is, and "Use when planning implementation strategy, selecting development approach, or defining verification criteria" is an explicit trigger clause with concrete phrases. It falls short of anchor 5 because the 'what' is vague — a 'framework' does not clearly state what the skill actually does.

4 / 5

Trigger Term Quality

The phrases "planning implementation strategy," "selecting development approach," and "verification criteria" are plausible things a user would say, but common variations and synonyms (e.g., "choosing an approach," "implementation plan," "how to structure the change") are missing. This sits squarely on the 'some relevant keywords but missing common variations' anchor, not the good-coverage anchor above.

3 / 5

Distinctiveness Conflict Risk

The implementation-strategy niche is somewhat specific, but triggers like "planning implementation strategy" overlap with general planning, architecture, and design-decision skills, and nothing distinctive separates it from those. It is more specific than the broadly-overlapping anchor 2 yet not 'mostly distinct' enough for anchor 4.

3 / 5

Total

12

/

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

shinpr/claude-code-workflows

Path

skills/implementation-approach/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.