What is the primary purpose of the cwf:refactor skill?

It serves as a maintenance heartbeat for your development environment, detecting drift between code, skills, and documentation to keep capabilities synchronized and clean.

Does it support documentation maintenance?

Yes, it includes a dedicated docs review mode that checks for consistency, broken links, and structural optimization across your project's documentation.

What is Holistic Analysis mode?

Holistic mode performs cross-plugin analysis to optimize global interactions between all installed and authored skills and hooks.

Can this skill review my entire codebase?

Yes, using the --codebase flag, it performs a contract-driven scan or a deep review using expert sub-agents to identify architectural risks and improvement areas.

How does the Tidy mode work?

Tidy mode analyzes recent commits for safe cleanup opportunities, such as removing dead code or adding guard clauses, based on the 'Tidy First?' philosophy.

Code Health & Refactor

Name: Code Health & Refactor
Author: corca-ai

bycorca-ai

•

Developer Tools

Optimizes codebase health and synchronizes skills through multi-mode refactoring, automated tidying, and documentation consistency checks.

The cwf:refactor skill is a comprehensive maintenance engine designed to prevent architectural drift as project capabilities expand. It offers a spectrum of analysis modes—from lightning-fast structural scans of installed plugins to deep, expert-led reviews of specific skills or entire codebases. By leveraging parallel sub-agents and contract-driven validation, it automates routine tidying, ensures documentation stays in sync with implementation, and provides holistic cross-plugin insights to keep your AI-powered development environment lean and performant.

Key Features

0173 GitHub stars

02Automated documentation consistency and link verification

03Contract-driven codebase validation for architectural consistency

04Commit-based automated tidying following Kent Beck’s philosophy

05Parallel sub-agent execution for deep expert-lens diagnostics

06Multi-mode analysis including Quick Scan, Deep Review, and Holistic Analysis

Use Cases

01Automating documentation audits to ensure READMEs match code changes

02Preventing technical debt and drift in complex multi-plugin repositories

03Performing deep-dive diagnostics on specific skills requiring targeted optimization

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add corca-ai/claude-plugins refactor

For use in Claude.ai and ChatGPT

Download Skill