CtrlK
BlogDocsLog inGet started
Tessl Logo

incremental-implementation

Delivers changes incrementally. Use when implementing any feature or change that touches more than one file. Use when you're about to write a large amount of code at once, or when a task feels too big to land in one step.

54

Quality

60%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

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

Quality

Discovery

57%

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 strong completeness with explicit 'Use when' clauses covering multiple trigger scenarios, but suffers from vague capability specification—'delivers changes incrementally' doesn't explain what concrete actions the skill performs. The trigger conditions are so broad (any multi-file change) that this skill would likely fire too often, creating conflict with other development skills.

Suggestions

Add specific concrete actions the skill performs, e.g., 'Breaks large changes into smaller, reviewable commits/PRs, implements features file-by-file, and verifies each step before proceeding.'

Narrow the trigger conditions or add more distinctive terms to reduce conflict risk, e.g., mention 'incremental commits', 'split into smaller PRs', 'step-by-step implementation' as trigger terms.

DimensionReasoningScore

Specificity

The description uses vague language like 'delivers changes incrementally' without specifying concrete actions. It doesn't describe what specific techniques or steps are involved—no mention of branching, committing, splitting PRs, or any other concrete development actions.

1 / 3

Completeness

The description answers both 'what' (delivers changes incrementally) and 'when' with explicit trigger conditions: multi-file changes, large code writes, and tasks too big for one step. The 'Use when' clauses are clearly stated.

3 / 3

Trigger Term Quality

Includes some relevant phrases like 'more than one file', 'large amount of code', and 'too big to land in one step' which are somewhat natural triggers. However, it misses common terms users might say like 'break up changes', 'split PR', 'incremental commits', 'step by step implementation', or 'refactor'.

2 / 3

Distinctiveness Conflict Risk

The triggers 'implementing any feature or change that touches more than one file' and 'large amount of code' are extremely broad and would match a huge number of development tasks, potentially conflicting with many other coding-related skills. However, the 'incremental delivery' angle provides some distinctiveness.

2 / 3

Total

8

/

12

Passed

Implementation

62%

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

This is a solid methodology skill with clear workflow structure and useful examples, but it's overly verbose for Claude's context window. The content explains principles Claude already understands (simplicity, scope discipline) at length, and the overlap between 'Common Rationalizations' and 'Red Flags' sections adds redundancy. The workflow clarity is the strongest dimension, with explicit validation checkpoints and a well-defined increment cycle.

Suggestions

Cut 'Common Rationalizations' and 'Red Flags' sections down to a single concise list — they overlap heavily and Claude doesn't need persuasion about why incremental development is good.

Remove or drastically shorten Rule 0 (Simplicity First) and Rule 0.5 (Scope Discipline) — these are general engineering principles Claude already knows; keep only the 'NOTICED BUT NOT TOUCHING' output format as that's the actionable part.

Consider splitting slicing strategies (Vertical, Contract-First, Risk-First) into a separate reference file to keep the main SKILL.md focused on the core increment cycle and checklist.

DimensionReasoningScore

Conciseness

The skill is well-written but verbose for its target audience. Sections like 'Common Rationalizations' and 'Red Flags' overlap significantly. The simplicity check examples and some implementation rules (Rule 4: Safe Defaults) explain concepts Claude already understands. The ASCII diagram adds little value. Could be tightened by ~30-40%.

2 / 3

Actionability

The skill provides concrete examples of slicing strategies and implementation patterns, but much of the guidance is philosophical/principled rather than executable. Code examples are illustrative rather than copy-paste ready for a specific task. The checklist items reference specific commands (npm test, npm run build) which is good, but the skill is more of a methodology guide than a concrete how-to.

2 / 3

Workflow Clarity

The increment cycle is clearly sequenced (Implement → Test → Verify → Commit → Next slice) with explicit validation checkpoints. The checklist after each increment provides concrete verification steps. The feedback loop is well-defined — test each slice before moving on, and the 'Common Rationalizations' table reinforces why skipping steps is dangerous.

3 / 3

Progressive Disclosure

The content is well-structured with clear headers and logical sections, but it's a monolithic document (~200 lines) with no references to supporting files. The slicing strategies, implementation rules, and rationalizations table could be split into separate reference files. The one cross-reference to 'git-workflow-and-versioning' is well-signaled, but the document would benefit from more modular organization.

2 / 3

Total

9

/

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
addyosmani/agent-skills
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.