How does this differ from standard search and replace?

Standard tools use text patterns or regex which can match text inside strings or comments by mistake. This skill uses Abstract Syntax Trees (AST) to understand the code structure, ensuring it only targets actual code elements.

Is it safe to use for large-scale changes?

Yes, the skill follows a strict safety workflow including discovery, planning, and mandatory user approval before applying any destructive transformations.

Which programming languages are supported?

It supports a wide range of popular languages including JavaScript, TypeScript, Python, Go, Rust, Java, C, C++, C#, Kotlin, Swift, Ruby, and PHP.

Do I need to have ast-grep installed?

Yes, this skill relies on the ast-grep CLI. It will check for the installation and can guide you through installing it via Homebrew or other package managers if missing.

AST-Aware Code Refactoring

Name: AST-Aware Code Refactoring
Author: bcowdery

bybcowdery

0•

开发者工具

Performs systematic, syntax-aware code transformations and pattern-based refactoring across entire repositories using ast-grep.

The AST-Aware Code Refactoring skill empowers Claude to perform complex, structural changes to source code by leveraging abstract syntax trees (AST). Unlike standard text-based search-and-replace, this skill understands language structure, allowing it to accurately rename variables, migrate API patterns, and modernize syntax across large codebases without breaking logic. It provides a comprehensive workflow from discovery and impact analysis to planning and interactive execution, ensuring that bulk transformations are handled safely and consistently across multiple files.

主要功能

01Syntax-aware search and replace using ast-grep

02Interactive refactoring with dry-run and verification steps

03Mass renaming of functions, classes, and variables across scopes

04Structural code architecture restructuring and module splitting

05Automated API migration and syntax modernization (e.g., var to const)

060 GitHub stars

使用场景

01Standardizing logging or error handling patterns across multiple microservices

02Refactoring legacy variable declarations and function signatures with scope awareness

03Migrating deprecated library calls to modern equivalents across a large repository

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bcowdery/claude-skills ast-refactor

For use in Claude.ai and ChatGPT

Download Skill