Dev & Engineering incremental-developmentvertical-slicestest-verificationfeature-flagssafe-defaultsrollback-friendlygit-commits

Incremental Implementation

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

FollowSkills review · FSRS-2.0
Not recommended
52/ 100 5-point scale 2.6 / 5
Trust17 / 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.

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

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

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

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

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

Evidence confidence:Low Reviewed Jul 20, 2026 Reviewed revision 2fbfa004a019
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.
Review evidence [1][2][3][4][5]
See the full review method →

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.

  1. A developer is adding a feature across the database, API, and UI and wants each end-to-end slice to remain usable.
  2. A backend and frontend team needs to agree on an API contract before implementing in parallel.
  3. An engineer is refactoring existing code while keeping the project compilable and existing tests passing after every increment.
  4. 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.
  5. A developer is tempted to write more than roughly 100 lines before running tests.

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 do you install this skill?

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.

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.

How does this skill compare with similar options?

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.

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.

Automation & Ops

Safe Launch

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

Dev & Engineering

Deprecation & Migration

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

Dev & Engineering

Git Workflow & Release Discipline

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

Dev & Engineering

Test-Driven Development Workflow

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

Dev & Engineering

Planning & Task Breakdown

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

Dev & Engineering

Doubt-Driven Development

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

Dev & Engineering

Source-Driven Development

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

Dev & Engineering

Context Engineering

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

Dev & Engineering

Systematic Debugging & Recovery

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

Dev & Engineering

Engineering Workflow Navigator

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

Dev & Engineering

Browser DevTools Testing

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

Dev & Engineering

Intent Interviewer

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

Dev & Engineering

Code Clarity Refactor

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

Dev & Engineering

Spec-Driven Development

Turn ambiguous engineering requests into testable specifications before coding.

Dev & Engineering

Performance Optimization Engineering Skill

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

Dev & Engineering

Architecture Decisions & Docs

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

Design & Frontend

Production Frontend UI Engineering

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

Automation & Ops

Production Observability

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

Automation & Ops

Security Hardening Engineering Skill

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

Related skills