How does this skill handle broken imports during refactoring?

It utilizes a dependency-ordered approach, updating shared interfaces and exports before modifying consumers, followed by immediate type-checking to catch broken imports early.

Why does the skill recommend editing tests last?

Editing source code first ensures the implementation is sound; tests are updated last to validate the new behavior and ensure no regressions were introduced during the refactor.

What validation tools does the multi-file editing strategy support?

While the documentation references Bun and Ripgrep, the strategy is tool-agnostic and works with any command-line type-checker, linter, or test runner relevant to your stack.

Can I use this skill for large-scale system migrations?

Yes, it includes specific strategies for 'Staged Changes' designed for high-risk migrations that require checkpoints, incremental validation, and team reviews.

Multi-File Code Editing

Name: Multi-File Code Editing
Author: hgeldenhuys

byhgeldenhuys

•

Developer Tools

Coordinates complex code changes across multiple files using proven dependency-ordering strategies and validation workflows.

The Multi-File Editing skill provides Claude with a structured framework for executing large-scale refactors, API updates, and system migrations safely and efficiently. By prioritizing changes based on a project's dependency graph—moving from shared interfaces and core logic through to API layers and finally tests—this skill minimizes broken builds and circular dependency errors. It assists developers in creating detailed change plans, executing edits in logical phases, and performing rigorous validation at every checkpoint to ensure repository integrity throughout the entire transformation process.

Key Features

01Atomic, incremental, and staged editing strategies for varied risk levels

02Automated change planning and impact analysis across directories

03Symbol impact detection using ripgrep for tracking references and imports

04Integrated validation workflows using type-checkers and test runners

05Dependency-aware change ordering (Interfaces first, Tests last)

061 GitHub stars

Use Cases

01Refactoring shared TypeScript types or interfaces across a distributed codebase

02Updating API contracts and migrating all downstream consumers and handlers

03Executing large-scale renaming of core symbols and business logic components

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add hgeldenhuys/claude-code-sdk multi-file-editing

For use in Claude.ai and ChatGPT

Download Skill