CtrlK
BlogDocsLog inGet started
Tessl Logo

implementation-approach

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

60

Quality

69%

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

60%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 content is a well-structured seven-phase methodology with explicit sequencing, stop conditions, and a closing checklist, giving strong workflow clarity. Its weaknesses are verbosity from re-explaining well-known design patterns and actionability that stays at an abstract conceptual level.

Suggestions

Remove or condense the one-line glosses of well-known patterns (Strangler, Facade, Adapter, Feature/Feature-driven, etc.) since Claude already knows them; keep only the author's original selection criteria for when each applies.

Make the Phase 2 convergence steps more concrete by showing a short worked trace (a small before/after decision with the subtraction check applied) so the procedure is actionable rather than purely abstract.

Consider moving the pattern catalog (Legacy/New Development/Integration strategies) and the risk/constraint category tables into a separate reference file to tighten the main SKILL.md overview.

DimensionReasoningScore

Conciseness

The body is mostly efficient procedural prose for the author's novel convergence methodology, but it glosses well-known concepts Claude already knows (e.g. 'Strangler Pattern: Gradual migration through phased replacement', 'Facade Pattern: Complexity hiding through unified interface'), which is unnecessary padding; this fits 'mostly efficient but includes some unnecessary explanation'.

3 / 5

Actionability

As an instruction-only methodology skill it provides concrete procedural steps ('Form the simplest end-to-end path', 'Remove each proposed addition and re-test its governing condition') and explicit quality-check checklists, but the guidance remains abstract and conceptual rather than fully concrete, fitting 'some concrete guidance but incomplete' rather than the mostly-executable level 4.

3 / 5

Workflow Clarity

Seven phases are clearly sequenced with explicit checkpoints (Phase 1's 'Stop when...' criteria, Phase 2's ordered Evidence/Subtraction checks with a re-test feedback loop, and a closing Quality Checks checklist), matching 'clear sequence with most checkpoints present'; it stays at 4 rather than 5 because the validation gates are conceptual stop-conditions rather than concrete pass/fail verification commands.

4 / 5

Progressive Disclosure

The body is well-organized into clearly headed sections (phases, verification levels, integration points, quality checks, guidelines) with no bundle files and no nested references; the pattern glossary and risk/constraint catalogs are inline reference-like content that could arguably be split out, giving 'good structure; minor organization gaps' rather than a clean level 5.

4 / 5

Total

14

/

20

Passed

Description

78%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 well-formed: it states the skill's purpose and provides an explicit 'Use when...' clause with three concrete triggers. Its main weakness is that the named actions are abstract conceptual verbs rather than tangible capabilities, which limits specificity.

DimensionReasoningScore

Specificity

The description names the domain ('Implementation strategy selection framework') and three actions ('planning implementation strategy, selecting development approach, or defining verification criteria'), but the actions are abstract conceptual verbs rather than tangible operations, fitting the 'names domain and 1-2 concrete actions but not comprehensive' anchor rather than the more concrete level 4.

3 / 5

Completeness

It explicitly answers both 'what' ('Implementation strategy selection framework') and 'when' with a concrete 'Use when...' clause listing three trigger conditions, matching the level-5 anchor for clearly and explicitly answering both with concrete trigger phrases.

5 / 5

Trigger Term Quality

Three distinct natural trigger phrases ('planning implementation strategy', 'selecting development approach', 'defining verification criteria') give good keyword coverage beyond the single-keyword level-3 anchor, though common synonyms like 'how to implement' or 'build approach' are missing, keeping it just below level 5.

4 / 5

Distinctiveness Conflict Risk

The implementation-strategy-selection niche is fairly distinct with specific triggers unlikely to fire for unrelated skills, but 'planning implementation strategy' has minor overlap risk with general planning or architecture skills, placing it at level 4 rather than the minimal-conflict level 5.

4 / 5

Total

16

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
shinpr/claude-code-workflows
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.