System Documentation

What problem does it solve?

This skill provides deterministic, non-destructive configuration file modifications using a tiered tool hierarchy to avoid overwriting existing user settings across projects.

Core Features & Use Cases

  • Deterministic edits across structured files like devbox.json, Cargo.toml, and other project configs without overwriting user settings
  • Project-aware editing with automatic tool selection (surgical-edit.sh) and backups
  • Automatic mirroring backups and post-edit validation to ensure consistency
  • Reuse patterns and templates for multi-file edits while preserving formatting

Quick Start

  • Modify a Cargo.toml dependency: ./scripts/surgical-edit.sh Cargo.toml '.dependencies += {"serde": "1.0"}'
  • Add a package to devbox.json: ./scripts/surgical-edit.sh devbox.json '.packages += ["nodejs", "rust"]'
  • Run project-aware edits: ./scripts/surgical-edit.sh --detect-project package.json '.dependencies += {"lodash": "^4.17.21"}'

Dependency Matrix

Required Modules

None required

Components

scripts

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: surgical-config
Download link: https://github.com/levonk/dotfiles/archive/main.zip#surgical-config

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.