A specialized AI agent skill designed to streamline codebase structure and readability without altering functional behavior.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install code-refactor
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 code-refactor 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 Code Refactor?
The Code Refactor skill is a technical powerhouse within the Openclaw Skills library, focusing exclusively on improving the internal architecture of your local codebase. It targets technical debt by simplifying control flows, eliminating redundancy, and enhancing naming conventions while strictly preserving existing software behavior.
This skill ensures that your development cycle remains efficient by focusing on code health. By integrating this into your Openclaw Skills workflow, developers can transform tangled legacy code into clean, modular, and maintainable systems without the risk of introducing side effects or breaking public interfaces.
Code Refactor Use Cases
- Reducing code duplication through abstraction.
- Simplifying complex nested conditional logic and control flows.
- Improving variable and function naming for better team communication.
- Reorganizing module structures to adhere to Clean Code principles.
- Preparing a codebase for future features by improving its underlying structure.
How Code Refactor Works
- Behavior Baseline: The skill first analyzes and confirms the current behavior of the code to ensure a safe transition.
- Problem Identification: It identifies specific smells such as long functions, tangled responsibilities, or poor naming.
- Interface Preservation: Unless explicitly directed, the skill maintains public APIs and existing call expectations.
- Logic Extraction: Common logic is extracted into reusable modules only when it significantly reduces overall complexity.
- Functional Isolation: The workflow strictly avoids adding new business logic during the refactoring process.
- Documentation Sync: Existing comment styles are preserved or updated if they have become obsolete.
- Validation: A final verification step ensures the logic remains identical to the pre-refactor state.
Code Refactor Setup
To enable this capability in your environment, add the code-refactor definition to your local Openclaw Skills configuration directory.
# Example of triggering the refactor skill via CLI
openclaw run code-refactor --path ./src/components
Code Refactor Data Schema & Taxonomy
The Code Refactor skill generates a structured report and modified source files. The output taxonomy includes:
| Data Point | Description |
|---|---|
| Issue Log | A detailed list of architectural problems identified before the refactor. |
| Refactor Strategy | The logical approach taken to reorganize the code. |
| Invariance Proof | Documentation on how functional behavior was preserved. |
| Validation State | Confirmation of the verification tests performed post-refactor. |
Code Refactor Advanced Features
- Multi-module logic extraction for complex system reorganization.
- Intelligent preservation of legacy comment styles and documentation blocks.
- Context-aware renaming that aligns with project-wide naming conventions.
- Automated identification of 'Code Smells' across diverse programming languages.
SKILL.md
Loading
Related Openclaw Skills
Git Discipline
A specialized skill for managing local Git repositories using safe, standardized, and reversible workflow practices.
KnowledgeKeeper
A comprehensive knowledge management tool designed to capture, categorize, and export structured information across various projects.
SQL Query Explain
An AI-powered SQL specialist for explaining execution plans, optimizing queries, and converting natural language into database commands.
SEO Audit Pro
Generate detailed technical SEO audits and keyword-focused content briefs automatically for any URL.
Shell Safe Exec
A secure execution environment for running non-destructive repository commands like testing, building, and linting within local workspaces.
Code Security Auditor
A specialized skill for identifying and fixing critical security vulnerabilities within application source code.
Featured*
