OpenParable
Skip to content
← Back to skills

Codemod Executor

Development
codemod-executor

Codemod Executor is an Agent Skill for development published in the a5c-ai/babysitter repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Execute automated AST-based code transformations for large-scale refactoring and migration

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/a5c-ai/babysitter/blob/HEAD/library/specializations/code-migration-modernization/skills/codemod-executor/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/codemod-executor, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Codemod Executor Skill

Executes automated code transformations using AST-based tools for large-scale refactoring, framework migrations, and language version upgrades.

Purpose

Enable automated code transformations for:

  • Framework migration (React, Angular, Vue)
  • Language version upgrades
  • API deprecation handling
  • Pattern standardization
  • Large-scale refactoring

Capabilities

1. AST-Based Transformations

  • Parse source code to AST
  • Apply transformation rules
  • Generate modified source
  • Preserve code style

2. Pattern Matching and Replacement

  • Define source patterns
  • Specify target patterns
  • Handle edge cases
  • Support wildcards and captures

3. Multi-File Transformations

  • Apply across entire codebase
  • Handle import updates
  • Coordinate cross-file changes
  • Manage side effects

4. Dry-Run Preview

  • Preview changes before applying
  • Generate diff reports
  • Estimate impact scope
  • Identify risky transformations

5. Rollback Support

  • Create transformation checkpoints
  • Enable selective rollback
  • Track applied codemods
  • Maintain change history

6. Custom Codemod Creation

  • Define new transformation rules
  • Test codemods in isolation
  • Document transformation logic
  • Share across teams

Tool Integrations

ToolLanguageIntegration Method
jscodeshiftJavaScript/TypeScriptCLI
ts-morphTypeScriptLibrary
RectorPHPCLI
ScalafixScalaCLI
OpenRewriteJavaCLI / Maven
BowlerPythonCLI
ast-grepMulti-languageCLI / MCP
gofmt -rGoCLI

Output Schema

{
  "executionId": "string",
  "timestamp": "ISO8601",
  "codemod": {
    "name": "string",
    "version": "string",
    "description": "string"
  },
  "results": {
    "filesProcessed": "number",
    "filesModified": "number",
    "filesSkipped": "number",
    "transformations": "number"
  },
  "changes": [
    {
      "file": "string",
      "transformations": [
        {
          "type": "string",
          "line": "number",
          "before": "string",
          "after": "string"
        }
      ]
    }
  ],
  "errors": [],
  "warnings": []
}

Integration with Migration Processes

  • code-refactoring: Large-scale refactoring
  • framework-upgrade: Framework migrations
  • language-version-migration: Syntax upgrades
  • code-translation: Language conversion assist

Related Skills

  • refactoring-assistant: Suggests transformations
  • static-code-analyzer: Pre-transformation analysis

Related Agents

  • code-transformation-executor: Orchestrates codemods
  • framework-upgrade-specialist: Framework-specific codemods