ReddRadar
Agent skill
codemod-generator
Generate automated code migration scripts (codemods)
Install this agent skill to your Project
npx add-skill https://github.com/a5c-ai/babysitter/tree/main/library/specializations/sdk-platform-development/skills/codemod-generator
SKILL.md
Codemod Generator Skill
Overview
This skill generates automated code migration scripts (codemods) that transform consumer code to use new API versions, reducing the burden of SDK upgrades on developers.
Capabilities
- Create AST-based code transformations
- Support multiple languages (JavaScript, TypeScript, Python, Go)
- Provide dry-run mode with change preview
- Implement safe rollback mechanisms
- Generate detailed migration reports
- Handle edge cases and partial migrations
- Support interactive migration modes
- Validate transformations with tests
Target Processes
- Backward Compatibility Management
- Package Distribution
- SDK Versioning and Release Management
Integration Points
- jscodeshift for JavaScript/TypeScript
- libcst for Python
- go-codemod for Go
- Rector for PHP
- Custom AST transformers
Input Requirements
- Source and target API versions
- Transformation rules specification
- Test cases for validation
- Edge case handling requirements
- Rollback strategy
Output Artifacts
- Codemod scripts per language
- Dry-run reports
- Migration validation tests
- Edge case documentation
- CLI wrapper for execution
- Rollback scripts
Usage Example
skill:
name: codemod-generator
context:
sourceVersion: "1.x"
targetVersion: "2.0"
languages:
- typescript
- python
transformations:
- type: methodRename
from: oldMethod
to: newMethod
- type: parameterChange
method: createResource
changes:
- name: config
wrap: options
dryRun: true
generateTests: true
Best Practices
- Always provide dry-run mode first
- Generate comprehensive change reports
- Handle partial migrations gracefully
- Include rollback capabilities
- Test codemods against real codebases
- Document manual intervention cases
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?