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

70%

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-fullstack/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

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 clearly sequenced 7-phase decision framework with conceptual validation checkpoints and a final quality checklist, but it is written in dense abstract jargon with redundant restatements of the convergence logic, no worked example, and a dangling external reference. It would benefit from tightening, one concrete end-to-end example, and moving reference material into bundle files.

Suggestions

Tighten Phase 2 and remove the convergence/subtraction logic restated in Phase 7, Quality Checks, and Guidelines; replace the twelve-dimension complexity list sentence with a compact table or short list.

Add a short worked example (e.g., a single feature request walked through Phases 1-7 to a Selected Design) so the abstract procedure becomes executable guidance.

Move the reference pattern catalogs and the verification/integration level definitions into a references/ file, and remove or resolve the 'coding-principles Reference Representativeness' mention, since no such bundle file exists.

DimensionReasoningScore

Conciseness

The body avoids explaining concepts Claude already knows and is information-dense, but the convergence/subtraction logic is restated across Phase 2, Phase 7, Quality Checks, and Guidelines, and sentences like Phase 2 step 3 (which packs twelve complexity dimensions into a single clause) could be substantially tightened. Not 4 because the redundancy and abstract padding exceed minor instances; not 2 because there is no beginner-level padding and every section carries substantive guidance.

3 / 5

Actionability

Concrete elements exist (numbered phases with core questions, L1/L2/L3 verification definitions, named patterns with application conditions, explicit stop conditions), but the guidance is largely abstract reasoning direction with no worked example, and "coding-principles Reference Representativeness" points to material absent from the bundle. Not 4 because a model cannot execute this framework without inventing the intermediate artifacts itself; not 2 because the phases, definitions, and checklists provide real, followable structure.

3 / 5

Workflow Clarity

Phases 1-7 are explicitly sequenced, each with a core question, and validation checkpoints are present: evidence classification (observed/inferred/unknown), the subtraction check, the Phase 1 stop condition, and a final Quality Checks checklist that verifies each phase's output. Not 5 because the checkpoints are conceptual rather than explicit validate-fix-retry loops and Phase 2's internal logic is difficult to follow; not 3 because sequence and per-phase output verification are clearly defined.

4 / 5

Progressive Disclosure

The document has clear section headers, but everything is inlined in a single ~155-line file with no bundle files at all; the reference pattern catalogs and the verification/integration level definitions are natural candidates for separate reference files, and the one external pointer ("coding-principles Reference Representativeness") resolves to no file in the bundle. Not 4 because content that belongs in separate files is inlined and the single external reference is unusable; not 2 because the section structure provides genuine organization and navigability.

3 / 5

Total

13

/

20

Passed

Description

70%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 explicitly answers both 'what' and 'when' with a well-formed 'Use when...' clause containing three distinct trigger conditions, and the trigger terms are natural for the niche. Its main weakness is the abstract 'framework' framing: no concrete capabilities are enumerated, and common trigger variations are missing.

DimensionReasoningScore

Specificity

"Implementation strategy selection framework" names the domain and "selecting development approach, or defining verification criteria" list 1-2 actions, but they remain abstract planning activities rather than the concrete, comprehensive action list of the higher anchors. Not 2 because it goes beyond bare domain-naming with multiple action phrases; not 4 because no specific concrete capabilities are enumerated.

3 / 5

Completeness

The description states what it is ("Implementation strategy selection framework") and explicitly when to use it via a "Use when planning implementation strategy, selecting development approach, or defining verification criteria" clause. Not 5 because the 'what' is an abstract 'framework' label without concrete capability statements; not 3 because the 'when' is explicit, not merely implied.

4 / 5

Trigger Term Quality

"planning implementation strategy", "selecting development approach", and "defining verification criteria" are phrases a user would plausibly say when needing this skill. Not 5 because common natural variations (e.g., "how to implement this", "design approach", "rollout plan") and synonyms are missing; not 3 because the included terms are relevant and natural rather than generic.

4 / 5

Distinctiveness Conflict Risk

Triggers like "implementation strategy", "development approach", and "verification criteria" carve a distinct niche (strategy selection) that is unlikely to fire for unrelated skills. Not 5 because broad 'planning' usage could overlap with general planning or architecture skills; not 3 because the trigger phrases are specific to this skill's domain rather than broadly overlapping.

4 / 5

Total

15

/

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