Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add jeremylongshore/tons-of-skills-marketplace --skill windsurf-multi-file-editing -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/windsurf-multi-file-editing/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/windsurf-multi-file-editing/

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

Similar skills

All skills for Agent setup: memory, context, orchestration →
run-affected-test-suite-end-to-end-after-multi-file-signature-ch ZaxbyHub run-affected-test-suite-end-to-end-after-multi-file-signature-ch is a Claude Code skill that runs affected tests and checks every call site after function signatures change across files. CX Codex +1 ★ 539repo stars file-organization akillness file-organization picks the boundary for your files — feature, shared layer, route segment or workspace package — and plans the move without breaking imports. CX Codex +1 406installs saas-multi-tenant davila7 saas-multi-tenant guides the agent in structuring multi-tenant SaaS backends with PostgreSQL and TypeScript. Sets up database row policies, request context middleware, and query filtering. CX Codex +1 171installs salesforce-apex-cursorrules-prompt-file PatrickJS salesforce-apex-cursorrules-prompt-file — a Cursor rule that shapes how the assistant writes Salesforce Apex. You drop it into a project when Apex classes and async logic are generated by the agent. CX Codex +1 ★ 41,178repo stars code-style-consistency-cursorrules-prompt-file PatrickJS code-style-consistency-cursorrules-prompt-file — a Cursor rule that makes the agent study your codebase conventions first and write new code to match them. Useful in repos with an established style. CX Codex +1 ★ 41,178repo stars om-implement-feature-multi-optimized open-mercato om-implement-feature-multi-optimized is a Claude Code skill that routes feature work to configured implementation workers and independent review advisors. It stages the result without publishing. CX Codex +1 501installs

From the same set139

The whole set →
gcs-bucket-config gcs-bucket-config automates Google Cloud Storage bucket configuration in Claude Code. Generates configs and gcloud commands for your storage setups. CX Codex +1 1installs s3-bucket-policy-generator The s3-bucket-policy-generator skill guides S3 bucket policy work, generates configurations, and checks results against common standards when AWS tasks call for it. CX Codex +1 1installs sqs-queue-setup Guides you through Amazon SQS queue setup and generates configurations. It activates on its own when SQS comes up in a request. CX Codex +1 1installs route53-record-manager route53-record-manager automates Amazon Route 53 DNS record management, writes configuration files, and runs AWS CLI commands directly in your coding agent. CX Codex +1 1installs managing-network-policies managing-network-policies builds Kubernetes NetworkPolicy manifests that enforce zero-trust networking between pods. For anyone who needs to lock down pod traffic with least privilege rules. CX Codex +1 1installs kubernetes-service-manager kubernetes-service-manager is a Claude Code skill that activates for Kubernetes tasks, generating configurations and providing step-by-step guidance for DevOps environment setup. CX Codex +1 1installs docker-container-basics The docker-container-basics skill assists with basic Docker container work, from guided steps to configuration generation and checks. It activates on Docker-related requests. CX Codex +1 1installs gitlab-ci-basics gitlab-ci-basics — a skill for everyday GitLab CI work: it walks through steps, writes pipeline configs and checks them for common mistakes. Activates on its own when gitlab shows up in a prompt. CX Codex +1 1installs

Project sponsors

Companies that keep this analytics open