CtrlK
BlogDocsLog inGet started
Tessl Logo

implementation-approach

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

28

Quality

18%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/implementation-approach/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

17%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This description is too abstract and jargon-heavy to be useful for skill selection. It fails to describe concrete actions the skill performs and uses generic terms that would conflict with many other development-related skills. The 'Use when' clause essentially restates the title rather than providing distinct, natural trigger terms.

Suggestions

Replace abstract language with specific concrete actions the skill performs, e.g., 'Compares incremental vs. big-bang implementation approaches, evaluates build-vs-buy tradeoffs, and generates phased rollout plans.'

Add natural trigger terms users would actually say, such as 'how should I build this', 'what approach should I take', 'phased rollout', 'build vs buy', 'migration strategy'.

Narrow the scope to a clear niche to reduce conflict risk—specify what kind of implementation strategies (e.g., software migration, feature rollout, system redesign) and what distinguishes this from general project planning skills.

DimensionReasoningScore

Specificity

The description uses vague, abstract language like 'implementation strategy selection framework', 'development approach', and 'verification criteria' without listing any concrete actions. There are no specific capabilities described—no verbs indicating what the skill actually does (e.g., compare approaches, generate plans, evaluate tradeoffs).

1 / 3

Completeness

It has a weak 'what' (framework for selecting implementation strategy) and does include a 'Use when...' clause, but both the what and when are so vague and overlapping that the 'when' doesn't add meaningful trigger guidance beyond restating the what in slightly different words.

2 / 3

Trigger Term Quality

The terms used ('implementation strategy', 'development approach', 'verification criteria') are abstract jargon rather than natural keywords a user would say. Users are unlikely to say 'I need an implementation strategy selection framework'—they'd more likely say 'how should I build this' or 'what architecture should I use'.

1 / 3

Distinctiveness Conflict Risk

Terms like 'implementation strategy', 'development approach', and 'planning' are extremely broad and would overlap with virtually any software development, architecture, or project planning skill. There is no clear niche or distinct trigger.

1 / 3

Total

5

/

12

Passed

Implementation

20%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill reads as an abstract strategic planning framework rather than actionable guidance for Claude. It is excessively verbose, explaining high-level concepts (design patterns, risk matrices, meta-cognitive questioning) that Claude already knows, while providing zero concrete examples, code, commands, or specific outputs. The phased structure provides some organizational clarity, but the lack of actionability severely limits its utility.

Suggestions

Replace abstract pattern descriptions with concrete examples showing how to apply each strategy to a real scenario (e.g., a sample Design Doc output for a specific migration case).

Remove explanations of well-known concepts (Strangler Pattern, Facade Pattern, 5 Whys) and instead provide a concise decision matrix or flowchart for strategy selection.

Add a concrete, copy-paste-ready template for the Phase 6 Design Doc output so Claude knows exactly what artifact to produce.

Condense the YAML checklists into a single compact reference table, cutting the document length by at least 50%.

DimensionReasoningScore

Conciseness

The content is highly verbose and largely describes abstract frameworks and meta-cognitive processes that Claude already understands. Most of the YAML blocks are conceptual checklists rather than actionable specifics, and terms like 'meta-cognitive' and 'comprehensive current state analysis' add no operational value. The entire document could be condensed to a fraction of its size.

1 / 3

Actionability

The skill provides no concrete code, commands, or executable examples. It consists entirely of abstract frameworks, checklists, and conceptual descriptions ('Strangler Pattern: Gradual migration through phased replacement') without showing how to actually apply any of them. There is nothing copy-paste ready or directly executable.

1 / 3

Workflow Clarity

The six phases are clearly sequenced and logically ordered, and the quality checks at the end provide some validation checkpoints. However, the phases themselves are abstract with no concrete validation steps—there's no feedback loop for error recovery, and the 'verification' steps are conceptual rather than executable.

2 / 3

Progressive Disclosure

The content is structured with clear headings and phases, which aids navigation. However, it's a monolithic wall of abstract content that could benefit from splitting detailed pattern descriptions and checklists into separate reference files. No bundle files exist to offload the extensive reference material.

2 / 3

Total

6

/

12

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.

Validation11 / 11 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.