windsurf-multi-file-editing — Claude Code skill
The windsurf-multi-file-editing skill coordinates edits across several files with Cascade. Use it for symbol renames, code moves, and refactors that must stay consistent.
MIT 1 installs ★ 2,935 updated 2026-11-01
npx skills add jeremylongshore/tons-of-skills-marketplace --skill windsurf-multi-file-editing -a claude-codeWhat windsurf-multi-file-editing does
The skill coordinates related changes across a project’s files through Cascade AI. It targets symbol renames, code moves, and cross-file refactoring where each edit needs to match the others.
Its workflow covers scoping the change, setting an operation template, generating a preview, applying the edit, and checking the result. The reported output can include changed files, an edit-history.json log, a rollback snapshot, and syntax-check results.
You need Windsurf installed and configured, an active Cascade AI subscription, a workspace containing .windsurf/, and Git or another version-control system. Without .windsurf/, the workspace misses a stated prerequisite for this skill.
What it helps with
- keep a symbol rename consistent across related files
- move code between files while preserving linked changes
- preview a batch of cross-file edits
- check syntax after a refactor
- save a rollback snapshot before applying changes
Example prompts for the agent
- Coordinate a rename for this symbol across every related file, show me the preview, then apply it.
- Move this code into the target file, update all linked references, and check the result.
- Run the multi-file operation and record its details in
edit-history.json.
How to install windsurf-multi-file-editing
1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill windsurf-multi-file-editing -a claude-code2Manually: put the files in place
~/.claude/skills/windsurf-multi-file-editing/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/windsurf-multi-file-editing/
1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill windsurf-multi-file-editing -a codex2Manually: put the files in place
.agents/skills/windsurf-multi-file-editing/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill windsurf-multi-file-editing -a cursor2Manually: put the files in place
.cursor/skills/windsurf-multi-file-editing/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install jeremylongshore/tons-of-skills-marketplace skills/.curated/windsurf-multi-file-editing2Manually: put the files in place
.github/skills/windsurf-multi-file-editing/SKILL.md1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill windsurf-multi-file-editing -a gemini-cli2Platform CLI
gemini skills install https://github.com/jeremylongshore/tons-of-skills-marketplace --path skills/.curated/windsurf-multi-file-editingManually: put the files in place
.devin/skills/windsurf-multi-file-editing/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill windsurf-multi-file-editing -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about windsurf-multi-file-editing
How do I install windsurf-multi-file-editing in Claude Code?
Run npx skills add jeremylongshore/tons-of-skills-marketplace --skill windsurf-multi-file-editing -a claude-code, then check ~/.claude/skills/windsurf-multi-file-editing/SKILL.md.
What does windsurf-multi-file-editing do?
It coordinates related edits across multiple files through Cascade AI. The workflow supports symbol renames, code moves, previews, and result checks.
What does this skill require?
It requires configured Windsurf, an active Cascade AI subscription, a workspace with .windsurf/, and Git or another version-control system.
Source text
SKILL.md · MIT
--- name: windsurf-multi-file-editing description: 'Manage multi-file edits with Cascade coordination. Activate when users mention "multi-file edit", "edit multiple files", "cross-file changes", "refactor across files", or "batch modifications". Handles coordinated multi-file operations. Use when working with windsurf multi file editing functionality. Trigger with phrases like "windsurf multi file editing", "windsurf editing", "windsurf". ' allowed-tools: Read,Write,Edit,Grep,Glob version: 1.0.0 license: MIT author: Jeremy Longshore <[email protected]> tags: - saas - skill-databases - windsurf-multi compatibility: Designed for Claude Code --- # Windsurf Multi File Editing ## Overview This skill enables coordinated multi-file editing operations within Windsurf using Cascade AI. It provides atomic changes across multiple files, ensuring consistency when renaming symbols, moving code, or making cross-file refactoring changes. ## Prerequisites - Windsurf IDE installed and configured - Active Cascade AI subscription - Project workspace initialized with `.windsurf/` directory - Git or version control for rollback safety - Understanding of project file structure and dependencies ## Instructions 1. **Scope the Operation** 2. **Configure Operation Template** 3. **Generate Preview** 4. **Execute with Preview** 5. **Verify Results** See [`references/implementation.md`](references/implementation.md) for detailed implementation guide. ## Output - Modified files with consistent changes applied - `edit-history.json` log with operation details - Rollback snapshot for recovery if needed - Validation report with syntax check results ## Error Handling See [`references/errors.md`](references/errors.md) for comprehensive error handling. ## Examples See [`references/examples.md`](references/examples.md) for detailed examples. ## Resources - [Windsurf Multi-File Editing Documentation](https://docs.windsurf.ai/features/multi-file-editing) - [Cascade AI Coordination Guide](https://docs.windsurf.ai/cascade/coordination) - [Atomic Operations Best Practices](https://docs.windsurf.ai/best-practices/atomic-ops)
© Jeremy Longshore · MIT · jeremylongshore/tons-of-skills-marketplace