surgical-edit

Execute minimal, targeted code edits directly from user requests.

1|Updated Jan 17, 2026
One-click install
npx skills add https://github.com/alexandersumer/config --skill surgical-edit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: surgical-edit
Source: https://github.com/alexandersumer/config/tree/main/.agents/skills/surgical-edit
Command: npx skills add https://github.com/alexandersumer/config --skill surgical-edit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The surgical-edit skill solves the need for implementing code changes without a formal plan, providing a direct and efficient way to edit, tweak, add, remove, rename, or adjust behavior.

Core Features & Use Cases

  • Direct Implementation: Perform code changes directly without a formal plan.
  • Behavior Adjustment: Adjust behavior and artifacts as requested.
  • Minimal Edit: Make the smallest complete edit that matches existing naming, layering, error handling, tests, and comment density.
  • Root Cause Fixing: Prefer fixing the root cause over patching the nearest symptom.
  • Proof Policy: Validate through a proof policy to ensure changes are correctly implemented.

Quick Start

Request a code change with the surgical-edit skill, specifying the exact behavior change needed.

Frequently Asked Questions about surgical-edit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is a surgical code edit for adjusting application behavior?

A surgical code edit is a direct, minimal implementation that adjusts application behavior without requiring a formal plan. It makes the smallest complete change to match existing naming, error handling, and tests while targeting the root cause.

How do I implement minimal code changes without a formal plan?

To implement minimal code changes without a formal plan, request the exact behavior adjustment needed. The process executes direct edits, prioritizing root cause fixing and matching existing layering and comment density.

When do I need to make minimal targeted edits to existing code?

You need to make minimal targeted edits when rapid changes are required and a formal plan is unnecessary. This approach is ideal for direct tweaks, renaming variables, or adjusting behavior while maintaining existing conventions.

Does this approach to code changes fix the root cause or patch symptoms?

This approach to code changes explicitly prefers fixing the root cause over patching the nearest symptom. It ensures the direct implementation resolves the underlying issue rather than applying a superficial behavior adjustment.

What is the best way to ensure rapid code edits match existing error handling?

The best way to ensure rapid code edits match existing error handling is to apply a minimal edit policy. This validates that changes match existing naming, layering, tests, and comment density through a proof policy.

What are the limitations of executing direct code changes without a plan?

Executing direct code changes without a plan is limited to scenarios where rapid, targeted behavior adjustments are required. It is not suitable for complex refactoring that necessitates formal architectural planning and comprehensive design.