Implementation strategy selection framework. Use when planning implementation strategy, selecting development approach, or defining verification criteria.
28
18%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/implementation-approach/SKILL.mdQuality
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.
| Dimension | Reasoning | Score |
|---|---|---|
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%.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
68ecb4a
Table of Contents
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.