codebase-migrate
Run large codebase migrations and multi-file refactors. Uses the Composio CLI to coordinate issue tracking, batched PRs, and CI verification while the agent executes the transforms locally across hundreds of files.
npx skills add composio-community/awesome-codex-skills --skill codebase-migrate --agent codex
Same command for any agent — swap --agent for claude-code, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Codebase Migrate Coordinate framework upgrades, API renames, config rewrites, and structural refactors across hundreds of files. Local edits are driven by the agent; the [Composio CLI](https://docs.composio.dev/docs/cli) handles the surrounding ceremony: tracking issues, per-batch PRs, and CI verification. ## When to Use - Framework upgrade (React 17 → 19, Node 18 → 22, Django 4 → 5). - API rename across a monorepo (e.g., `getUserById` → `users.byId`). - Config/format migration (webpack → vite, eslint → biome, jest → vitest). - Any "change 200 files the same way" task that needs to ship in reviewable slices. ## Prereqs ```bash curl -fsSL https://composio.dev/install | bash composio login composio link github # for PRs + CI status composio link linear # or jira — for migration tracking ``` Local tools the agent will use directly: `git`, `rg`, `jscodeshift`/`ts-morph`/`comby`/`ast-grep` (language-appropriate), and your test runner. ## Planning Phase 1. **Define the transform precisely.** Bad: "migrate to vitest." Good: "replace `jest.mock` with `vi.mock`, swap `jest.fn()` for `vi.fn()`, rename `jest.config.js` → `vitest.config.ts` using template X." 2. **Scope the blast radius:** `
- When to Use
- Prereqs
- Planning Phase
- Execute in Reviewable Batches
- Workflow Script
- Safety Rails
- Verification Loop
- Troubleshooting
curl -fsSL https://composio.dev/install | bash
composio login
composio link github # for PRs + CI status
composio link linear # or jira — for migration tracking
rg -l 'jest\.(mock|fn|spyOn)' | wc -l
rg -l 'from "jest"' | sort
composio execute LINEAR_CREATE_ISSUE -d '{
Batch helper: first 25 untouched files matching the pattern
echo "$BATCH" > batch.list
git checkout -b migrate/vitest-batch-03What does the codebase-migrate skill do?
Run large codebase migrations and multi-file refactors. Uses the Composio CLI to coordinate issue tracking, batched PRs, and CI verification while the agent executes the transforms locally across hundreds of files.
How do I install it?
Run `npx skills add composio-community/awesome-codex-skills --skill codebase-migrate --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From composio-community/awesome-codex-skills, a repository with 15,591 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.