ReddRadar
Agent skill
codemod-executor
Execute automated AST-based code transformations for large-scale refactoring and migration
Install this agent skill to your Project
npx add-skill https://github.com/a5c-ai/babysitter/tree/main/library/specializations/code-migration-modernization/skills/codemod-executor
SKILL.md
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
| Tool | Language | Integration Method |
|---|---|---|
| jscodeshift | JavaScript/TypeScript | CLI |
| ts-morph | TypeScript | Library |
| Rector | PHP | CLI |
| Scalafix | Scala | CLI |
| OpenRewrite | Java | CLI / Maven |
| Bowler | Python | CLI |
| ast-grep | Multi-language | CLI / MCP |
| gofmt -r | Go | CLI |
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 transformationsstatic-code-analyzer: Pre-transformation analysis
Related Agents
code-transformation-executor: Orchestrates codemodsframework-upgrade-specialist: Framework-specific codemods
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
a5c-ai/babysitter
gsd-tools
Central utility skill for GSD operations. Provides config parsing, slug generation, timestamps, path operations, and orchestrates calls to other specialized skills. Acts as the unified entry point that the original gsd-tools.cjs provided via its lib/ modules (commands, config, core, init).
a5c-ai/babysitter
model-profile-resolution
Resolve model profile (quality/balanced/budget) at orchestration start and map agents to specific models. Enables cost/quality tradeoffs by selecting appropriate AI models for each agent role.
a5c-ai/babysitter
verification-suite
Plan structure validation, phase completeness checks, reference integrity verification, and artifact existence confirmation. Provides the structured verification layer ensuring GSD artifacts are well-formed and complete.
a5c-ai/babysitter
state-management
STATE.md reading, writing, and field-level updates. Provides cross-session state persistence via .planning/STATE.md with structured fields for current task, completed phases, blockers, decisions, and quick tasks.
a5c-ai/babysitter
git-integration
Git commit patterns, formats, and conventions for GSD methodology. Provides atomic commits per task, structured commit messages, planning file commits, branch management, and milestone tag operations.
a5c-ai/babysitter
frontmatter-parsing
YAML frontmatter parsing and manipulation for .planning/ documents. Provides read, write, update, query, and validation operations on frontmatter blocks in GSD markdown artifacts.
Didn't find tool you were looking for?