Dev & Engineering

Incremental Implementation

Deliver multi-file engineering changes through small, tested, reversible slices.

52/ 100
Use with care

Useful, but reliability, evidence or controls still have material gaps.

See how it was scored ↓
Works as-is in
Codex · Claude Code
Stars
★ 107k
Last updated
13d ago
License
MIT
incremental-developmentvertical-slicestest-verificationfeature-flags
+3safe-defaultsrollback-friendlygit-commits

What does this skill do, and when should you use it?

Incremental Implementation guides AI coding agents to break features, refactors, and other multi-file changes into thin vertical slices. Each slice completes one logical piece while keeping the project working and testable. The workflow is implement, test, verify, commit, then continue with the next slice. It also promotes simplicity, strict scope control, feature flags for incomplete work, safe defaults, and rollback-friendly changes.

Breaks multi-file work into vertical, contract-first, or risk-first slices; directs the agent to run the test suite or add a test after each slice; checks tests, builds, type checking, linting, and expected functionality; requires descriptive Git commits; and recommends disabled-by-default feature flags and minimal, focused modifications for incomplete or risky work.

Good fit
  • A developer is adding a feature across the database, API, and UI and wants each end-to-end slice to remain usable.
  • A backend and frontend team needs to agree on an API contract before implementing in parallel.
  • An engineer is refactoring existing code while keeping the project compilable and existing tests passing after every increment.
  • A team is working with an uncertain or high-risk component such as a WebSocket connection and wants to validate it before building on it.
  • A developer is tempted to write more than roughly 100 lines before running tests.

How do you install this skill?

Before you use it
  • “Commit” is mandatory for each increment, but user confirmation, branch policy, and safe handling of commit failures are unspecified; automated agents need an explicit boundary for external writes.
  • The test, build, type-check, and lint commands are assumptions and may not exist; the skill should first detect available commands and report missing dependencies diagnostically.
  • The skill references other skills and reference files whose contents are not included here, so standalone use may lack required context.
  • There is no Chinese-language guidance, language-agnostic example set, or adaptation guidance for restricted-network environments.
Before you start
Your agent needs
  • Shell / CLI
  • Local filesystem
Install first
  • Node.js
  • Git

This skill is part of the 24-skill addyosmani/agent-skills collection. Install the full collection with npx skills add addyosmani/agent-skills. To install this skill individually, use npx skills add addyosmani/agent-skills --skill incremental-implementation. The README does not document a complete platform-specific folder setup for installing only this skill.

Generic route: install into Claude Code manually (macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/addyosmani/agent-skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/incremental-implementation" ~/.claude/skills/
rm -rf "$tmp"

Generated from the source repository and skill path; it copies only this skill's folder. If the author's install steps above differ, follow those first. To scope it to one project, replace ~/.claude/skills with that project's .claude/skills.

How do you use this skill?

In a compatible coding agent, request a multi-file change in explicit increments. For example: Let's implement Task 3 incrementally. Start with just the database schema change and API endpoint. Don't touch the UI yet. After implementing, run npm test and npm run build. Require each slice to be implemented, tested, verified, and committed before moving on.

What are this skill's strengths and limitations?

Pros
  • Provides a concrete implement-test-verify-commit loop.
  • Offers vertical, contract-first, and risk-first slicing strategies.
  • Sets explicit guidance for simplicity, scope discipline, safe defaults, feature flags, and reversibility.
  • Includes checklists, red flags, and rebuttals to common reasons for skipping verification.
Limitations
  • It is an execution workflow, not a library, code generator, or domain-specific implementation.
  • The required verification and commit gates can add operational overhead to each slice.
  • The SKILL.md does not adapt commands to a specific project; its examples assume npm, TypeScript, and lint scripts are available.
  • The supplied material provides no test results or platform-specific validation for this individual skill.

How does this skill compare with similar options?

Side by side with related skills; every score comes from the same FSRS standard.

Skill FS score Stars Last updated License
Incremental Implementation this page 52 · Use with care ★ 107k 13d ago MIT
Writing Plans 53 · Use with care ★ 299k 17d ago MIT
Development Branch Finisher 44 · Not recommended ★ 299k 17d ago MIT
Azure App Configuration for Python ✓ Microsoft · Official 53 · Use with care ★ 2.7k 3mo ago MIT
Deprecation & Migration 48 · Use with care ★ 107k 13d ago MIT

The README names Superpowers and Matt Pocock's skills as alternatives and links to a comparison document, but the supplied material does not provide specific comparison conclusions for this skill.

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Use with care
52/ 100 5-point scale 2.6 / 5
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
1Trust17 / 25 · 3.4/5

The skill explicitly promotes safe defaults, scope discipline, and rollback-friendly increments, with no evidence of malware, credential theft, or covert exfiltration. It does not explain user confirmation for commits or other external effects, sensitive-data handling, dependency security, or data-flow disclosure, so points are deducted.

2Reliability8 / 20 · 2.0/5

The workflow is internally coherent and includes implementation, testing, verification, and stop-on-failure guidance. However, its commands and references to git-workflow-and-versioning and definition-of-done.md depend on the surrounding project environment; abnormal-input handling and reproducible execution evidence are absent, so the static score remains below 10.

3Adaptability10 / 15 · 3.3/5

The audience and scenarios for multi-file, large, and complex changes are clear, and simple single-file changes are explicitly excluded. Trigger boundaries remain broad, with no guidance for different languages, toolchains, projects without tests, Chinese-language use, or restricted-network environments, so points are deducted.

4Convention8 / 15 · 2.7/5

The document has a useful structure with overview, triggers, cycle, rules, checklists, and anti-rationalization guidance, while the README supplies installation information and the repository provides an MIT license. The selected skill lacks its own version, changelog, maintenance owner, or update path, and relies on unstated environment assumptions and external repository context.

5Effectiveness6 / 15 · 2.0/5

Thin slices, verification gates, feature flags, and rollback guidance are directly actionable for multi-file engineering work, so the core value is plausible. Actual benefit depends on the agent executing project-specific commands and commits, and no representative output or static proof of completed key paths is supplied; the static ceiling therefore requires a conservative deduction.

6Verifiability3 / 10 · 1.5/5

The skill names auditable checks including tests, builds, type checking, linting, and descriptive commits, and repository CI validates overall structure and installation. The supplied CI and fixture do not test this skill's behavior, and there is no independent reproduction or third-party execution evidence, so only limited credit is warranted.

1 2 3 4 5 6

Open a dimension to read why it scored that way

Reviewed Jul 20, 2026 Reviewed revision 2fbfa004a019 Review evidence[1][2][3][4][5]

Evidence confidence:Low — Mostly static review, author material or a limited demo; useful for discovery, not high-risk decisions.

See the full review method →

FAQ

Should I use it for a small single-file change?
Usually no. The skill explicitly excludes single-file, single-function changes whose scope is already minimal.
Does it automatically create commits?
It requires a descriptive Git commit after each increment, but the supplied material does not state that commits are automated.
How should incomplete functionality be merged?
Use a feature flag that is disabled by default so incremental work can be merged without exposing unfinished behavior.
What tooling does it require?
The body references shell commands, filesystem changes, Git, npm, npx, and TypeScript checks. The project must provide the relevant scripts and environment.

More skills from this repository

All from addyosmani/agent-skills

Automation & Ops

CI/CD Pipeline Automation

Build repeatable quality gates and reversible deployment pipelines for every change.

★ 107k FS 48 Use with care 13d ago
Automation & Ops

Safe Launch

Guides engineering teams through observable, reversible, and incremental production releases.

★ 107k FS 46 Use with care 13d ago
Dev & Engineering

Deprecation & Migration

A practical workflow for retiring legacy systems safely and moving users to replacements.

★ 107k FS 48 Use with care 13d ago
Dev & Engineering

Git Workflow & Release Discipline

Keep AI-generated changes reviewable, reversible, and ready to release.

★ 107k FS 54 Use with care 13d ago
Dev & Engineering

Test-Driven Development Workflow

Prove intended behavior with a failing test before implementing, refactoring, and verifying the change.

★ 107k FS 57 Use with care 13d ago
Dev & Engineering

Planning & Task Breakdown

Turn clear requirements into ordered, implementable, and verifiable engineering tasks.

★ 107k FS 54 Use with care 13d ago
Dev & Engineering

Doubt-Driven Development

Challenge non-trivial decisions with a fresh adversarial review before they stand.

★ 107k FS 52 Use with care 13d ago
Dev & Engineering

Source-Driven Development

Ground framework and library decisions in current official documentation instead of stale memory.

★ 107k FS 51 Use with care 13d ago
Dev & Engineering

Context Engineering

Helps coding agents load the right project context at the right time, reducing guesswork and convention drift.

★ 107k FS 49 Use with care 13d ago
Dev & Engineering

Systematic Debugging & Recovery

A structured workflow for finding root causes, fixing failures, and preventing recurrence.

★ 107k FS 49 Use with care 13d ago
Dev & Engineering

Engineering Workflow Navigator

Find and invoke the right engineering workflow skill for each task phase.

★ 107k FS 46 Use with care 13d ago
Dev & Engineering

Browser DevTools Testing

Validate and debug web applications with real-browser runtime evidence.

★ 107k FS 59 Recommended 13d ago
Dev & Engineering

Intent Interviewer

Clarify the real problem through one-question-at-a-time interviews before planning or coding.

★ 107k FS 59 Recommended 13d ago
Dev & Engineering

Code Clarity Refactor

Reduce code complexity while preserving exact behavior, so teammates can read, modify, and debug it faster.

★ 107k FS 57 Use with care 13d ago
Dev & Engineering

Spec-Driven Development

Turn ambiguous engineering requests into testable specifications before coding.

★ 107k FS 55 Use with care 13d ago
Dev & Engineering

Performance Optimization Engineering Skill

Measure, diagnose, and verify fixes for frontend, backend, query, and database performance bottlenecks.

★ 107k FS 54 Use with care 13d ago
Dev & Engineering

Architecture Decisions & Docs

Preserve engineering context by documenting decisions, APIs, and the reasons behind them.

★ 107k FS 53 Use with care 13d ago
Design & Frontend

Production Frontend UI Engineering

Guides AI coding agents to build accessible, responsive, design-system-aligned production interfaces.

★ 107k FS 53 Use with care 13d ago
Automation & Ops

Production Observability

Make production behavior visible and diagnosable with structured logs, metrics, traces, and actionable alerts.

★ 107k FS 53 Use with care 13d ago
Automation & Ops

Security Hardening Engineering Skill

Gives coding agents a structured defense workflow for untrusted input, authentication, sensitive data, and external service integrations.

★ 107k FS 52 Use with care 13d ago

Related skills