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

60%

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 ./dev-workflows-frontend/skills/implementation-approach/SKILL.md

The canonical home for this skill is implementation-approach in shinpr/claude-code-workflows

SKILL.md
Quality
Evals
Security

Quality

Content

48%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 presents a clearly sequenced, checkpointed decision framework, which is its main strength. However, it is noticeably verbose — re-explaining well-known patterns and repeating design-surface phrasing — and lacks any worked example showing the framework applied, leaving several directives abstract.

Suggestions

Cut the pattern glosses: replace the three strategy-pattern lists with just the pattern names plus the condition for considering each, since Claude already knows what Strangler, Facade, Adapter, Proxy, Decorator, and Bridge patterns are.

Add one short worked example (a small before/after scenario) that walks through Phase 2 convergence and a Phase 6 approach selection, so abstract directives like "select the lowest-total-complexity choice" become concrete.

Move the Reference Strategy Patterns catalog and the Verification Level / Integration Point definitions into a references/ file, keeping SKILL.md as a lean overview with clearly signaled one-level-deep links, and consolidate the design-surface rules stated in Phase 2, Phase 7, and Quality Checks into a single statement.

DimensionReasoningScore

Conciseness

One-line glosses of patterns Claude already knows ("Strangler Pattern: Gradual migration through phased replacement", "Facade Pattern: Complexity hiding through unified interface") pad the Reference Strategy Patterns section, and baroque nominalized prose ("Decision-Sufficient Current State Analysis", design-surface phrasing repeated across Phase 2, Phase 7, and Quality Checks) could be substantially tightened. This is anchor 2 (noticeably verbose, several unnecessary explanations) rather than 3 because the pattern catalog alone is roughly 20 lines of known-concept explanation.

2 / 5

Actionability

There is concrete guidance — an ordered phase sequence, an explicit comparison-dimension list ("user decisions, settings, modes, concepts, outputs..."), L1/L2/L3 verification definitions, and a Quality Checks checklist — but no worked example applying the framework, and directives like "Select the lowest-total-complexity choice that satisfies the condition" remain abstract without showing how. This matches anchor 3 (some concrete guidance but incomplete, missing key details) rather than 4.

3 / 5

Workflow Clarity

Phases 1–7 are clearly sequenced with explicit stop conditions ("Stop when the current-state facts... have been checked"), internal checkpoints (Evidence Check, Subtraction Check), and an end-of-process checklist. It falls short of anchor 5 because error-recovery loops are only implicit — there is no guidance for what to do when a check fails mid-process.

4 / 5

Progressive Disclosure

The skill is a well-headered 157-line monolith with no bundle files at all; supporting material that naturally belongs in references/ (the pattern catalog, Verification Level and Integration Point definitions) is inlined. This is anchor 3 (some structure, content that should be separate is inline) rather than 4, since the over-50-line exception for single-file skills does not apply and several sections are detachable reference material.

3 / 5

Total

12

/

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 a correct structure with an explicit "Use when" clause, but the capability statement is a domain label rather than a list of concrete actions, and its triggers lack natural synonyms. It would benefit from stating what the framework concretely produces and adding user-natural trigger phrases.

Suggestions

Replace the abstract "Implementation strategy selection framework" with concrete actions, e.g., "Selects between vertical-slice, horizontal-slice, and hybrid implementation approaches by analyzing the existing codebase, comparing total complexity, and assessing material risks".

Add natural trigger variations users would actually say, such as "how to structure the implementation", "build vs. refactor", "incremental migration", or "implementation plan".

Sharpen distinctiveness by naming the decision the skill governs (choosing an implementation approach and its verification level) so it does not compete with general planning or ADR-writing skills.

DimensionReasoningScore

Specificity

"Implementation strategy selection framework" names the domain but lists no concrete actions — nothing like "analyzes the existing codebase", "compares implementation strategies", or "documents the decision rationale". It matches anchor 2 (domain named, actions minimal/generic) rather than 3 because no specific action verbs appear at all.

2 / 5

Completeness

Both parts are present: a "what" ("Implementation strategy selection framework") and an explicit "Use when..." clause with three concrete trigger conditions. It falls short of anchor 5 because the "what" is abstract — it never says what the framework actually does (e.g., select between vertical/horizontal/hybrid approaches, assess risks, define verification levels).

4 / 5

Trigger Term Quality

Triggers like "planning implementation strategy", "selecting development approach", and "defining verification criteria" are phrases a technical user might say, but common variations and synonyms (e.g., "how to structure the change", "build vs. refactor", "rollout plan") are absent. This lands on anchor 3: some relevant keywords, missing natural variations.

3 / 5

Distinctiveness Conflict Risk

The domain is fairly niche, but broad triggers like "planning implementation strategy" would plausibly fire for general planning, design, or ADR-writing skills. It sits at anchor 3 (somewhat specific but could overlap with similar skills) rather than 4, since the overlap risk is with a whole family of planning-related skills, not just one closely related skill.

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

dev-workflows-frontend/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.