home / skills / openclaw / skills / ai-codemod

ai-codemod skill

safe

This skill generates AST-based codemods to safely refactor large-scale codebases with one command and zero-config setup.

npx playbooks add skill openclaw/skills --skill ai-codemod

Review the files below or copy the command above to add this skill to your agents.

Files (2)

SKILL.md

2.4 KB

---
name: codemod-gen
description: Generate codemods for large-scale code changes. Use when refactoring patterns across many files.
---

# Codemod Generator

You need to replace a pattern across 500 files. Find and replace won't cut it. This tool generates AST-based codemods that safely transform your code at scale.

**One command. Zero config. Just works.**

## Quick Start

```bash
npx ai-codemod "convert class components to functional"
```

## What It Does

- Generates jscodeshift codemods for your specific transformation
- Handles complex patterns like class to function conversions
- Preserves formatting and comments
- Works across entire codebases

## Usage Examples

```bash
# Class to functional components
npx ai-codemod "convert class components to functional"

# Modernize code
npx ai-codemod "replace lodash.get with optional chaining"

# API migrations
npx ai-codemod "migrate from moment to date-fns"

# Framework upgrades
npx ai-codemod "update React Router v5 to v6"
```

## Best Practices

- **Test on a branch first** - always run codemods on a fresh branch
- **Review the diff** - spot check that transformations are correct
- **Run incrementally** - do one file type at a time
- **Keep the codemod** - save it for future use

## When to Use This

- Major framework or library upgrades
- Enforcing new code patterns across the codebase
- Deprecating old APIs in favor of new ones
- Standardizing code style at scale

## Part of the LXGIC Dev Toolkit

This is one of 110+ free developer tools built by LXGIC Studios. No paywalls, no sign-ups, no API keys on free tiers. Just tools that work.

**Find more:**
- GitHub: https://github.com/LXGIC-Studios
- Twitter: https://x.com/lxgicstudios
- Substack: https://lxgicstudios.substack.com
- Website: https://lxgicstudios.com

## Requirements

No install needed. Just run with npx. Node.js 18+ recommended. Needs OPENAI_API_KEY environment variable.

```bash
npx ai-codemod --help
```

## How It Works

Takes your plain English description of the transformation and generates a jscodeshift codemod script. The AI understands AST manipulation and outputs a codemod you can run with jscodeshift or babel.

## License

MIT. Free forever. Use it however you want.

---

**Built by LXGIC Studios**

- GitHub: [github.com/lxgicstudios/ai-codemod](https://github.com/lxgicstudios/ai-codemod)
- Twitter: [@lxgicstudios](https://x.com/lxgicstudios)

Overview

This skill generates AST-based codemods to automate large-scale code changes across many files. It converts plain-English transformation descriptions into runnable jscodeshift or Babel codemod scripts. The tool preserves comments and formatting and is designed to work with minimal configuration.

How this skill works

Provide a short natural-language description of the transformation you need, and the skill produces an AST-aware codemod script that performs that change. The generated codemods target jscodeshift or Babel runtimes so you can run them across a repository. Output is designed to be reviewable: it focuses on safe AST transforms and leaves diffs you can inspect before committing.

When to use it

Refactoring a recurrent pattern across hundreds of files (e.g., rename prop or API surface).
Upgrading frameworks or libraries that require code migrations (React Router v5 → v6, moment → date-fns).
Replacing utility usages with modern language features (lodash.get → optional chaining).
Enforcing new coding conventions or deprecating old APIs at scale.
Making structural edits that simple find-and-replace would break (class → functional components).

Best practices

Run codemods on a feature branch and test the branch before merging.
Review generated diffs and run unit/integration tests after applying transforms.
Apply codemods incrementally (one file type or folder at a time) to limit blast radius.
Keep the generated codemod scripts in version control for future reuse.
Spot-check transformed files to ensure edge cases are handled as expected.

Example use cases

Convert React class components to functional components across a monorepo.
Migrate date handling from moment to date-fns in a large codebase.
Replace custom utility calls with native JS features using optional chaining.
Update API call signatures after a library upgrade and adapt callsites.
Standardize error-handling patterns or rename exported interfaces across many packages.

FAQ

Do I need to install anything?

No install is required; run the generator via npx. Node.js 18+ is recommended.

How safe are the automated transforms?

Transforms use AST-based edits to preserve structure and comments, but you should review diffs and run tests before merging.