An AI-driven CLI tool that provides instant refactoring suggestions with colored diffs for your source code.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install refactor-assist
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install refactor-assist using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Refactor Assistant?
Refactor Assistant is a developer-centric tool designed to streamline code reviews and improve software quality. As part of the Openclaw Skills ecosystem, it allows developers to point at any file and receive specific, actionable refactoring suggestions. It focuses on enhancing readability, adopting modern patterns, and reducing technical debt without requiring complex configuration.
This skill is part of a broader toolkit aimed at high-velocity development. By leveraging advanced language models, it acts as a pre-review stage, ensuring that your code is clean, efficient, and follows modern standards before it ever reaches a human reviewer.
Refactor Assistant Use Cases
- Preparing code for peer review by identifying potential improvements early.
- Cleaning up legacy codebases and addressing technical debt during dedicated sprints.
- Learning and applying modern coding patterns and best practices across various languages.
- Rapidly improving type safety and performance in specific modules or utility files.
How Refactor Assistant Works
- The user executes the tool via the command line targeting a specific source file.
- The skill reads the local file content and identifies the programming context.
- It sends the code to a high-performance LLM to analyze readability, duplication, and performance.
- The tool generates a localized, colored diff in the terminal showing exactly what to change.
- Optionally, the user can choose to apply these changes directly to the source file.
Refactor Assistant Setup
To use this tool within the Openclaw Skills framework, ensure you have Node.js 18 or higher installed. You will also need an OpenAI API key configured in your environment.
# Set your API key
export OPENAI_API_KEY='your_key_here'
# Run the assistant directly via npx
npx ai-refactor <filename>
Refactor Assistant Data Schema & Taxonomy
The skill operates primarily on a per-file basis and does not maintain a complex local database. Its data flow is organized as follows:
| Component | Type | Description |
|---|---|---|
| Input Source | File Path | The local source code file to be analyzed. |
| API Context | JSON | Metadata sent to the model including file content and focus area. |
| Output Diffs | ANSI String | Colored text representing additions and deletions. |
| Flags | CLI Args | Configuration for application (--apply) or focus (--focus). |
Refactor Assistant Advanced Features
- Direct file modification: Use the --apply flag to automatically rewrite your code based on suggestions.
- Focused Refactoring: Use the --focus parameter to target specific issues like 'error handling' or 'variable naming'.
- Zero Configuration: Works out-of-the-box without needing complex config files or local model training.
- Integration Friendly: Can be easily piped into other CLI tools or included in development scripts within the Openclaw Skills ecosystem.
SKILL.md
Loading
Related Openclaw Skills
Redis Schema Generator
An AI-powered utility that generates optimized Redis key patterns, data structures, and TTL configurations based on specific use case descriptions.
Redis Gen
An AI-powered CLI tool that generates optimized Redis key patterns, data structure designs, and TTL recommendations from natural language descriptions.
Readme Writer
Generate polished README.md files from your codebase automatically using AI-driven analysis.
README Gen
Automatically generates comprehensive, professional README.md files by analyzing your project's source code and metadata.
Refactor Assistant
Get instant, AI-driven refactoring suggestions with colored diffs to improve code quality and maintainability.
Refactor Assistant
A CLI-based refactoring tool that analyzes code for quality improvements and displays actionable colored diffs.
Featured*
