How does the workflow ensure my code doesn't break?

The workflow includes a mandatory 'Verify' step that runs your project's build process and test suite. It only commits changes if the build passes and no errors are detected.

What is Economy mode in the Clean Code skill?

Economy mode (-e) runs the workflow without subagents, using direct tool calls only. This is faster and more cost-effective for straightforward refactoring tasks.

Can I save the refactoring results for manual review?

Yes, using the -s flag enables 'Save mode,' which outputs the clean code recommendations and changes to a specific directory (.claude/output/clean-code/) for your review.

Which frameworks and libraries does this skill support?

This skill is optimized for modern web development, specifically supporting React 19, Next.js 15/16, Zustand v5, and TanStack Query v5.

Can I use this skill for automated bulk refactoring?

Yes, by using the -a (Auto) flag, you can skip manual confirmations, allowing the AI to scan, refactor, and commit changes autonomously.

Clean Code Workflow

Name: Clean Code Workflow
Author: flosrn

byflosrn

0•

生产力与工作流

Refactors and optimizes React and Next.js codebases using automated clean code principles and build verification.

The Clean Code Workflow is a specialized skill designed to modernize and maintain high-quality codebases by identifying technical debt and applying industry-standard best practices. It features deep integration with the modern frontend ecosystem, including React 19, Next.js 15, Zustand v5, and TanStack Query v5. By utilizing a systematic three-stage process—Scan, Apply, and Verify—this skill automates the detection of code smells, applies documentation-backed refactors, and ensures project stability through automated build and test verification before committing changes.

主要功能

01Parallel agent execution for rapid codebase analysis and issue identification

02Flexible execution modes including 'Auto' for hands-free updates and 'Economy' for cost-efficiency

03Automatic detection of React, Next.js, Zustand, and TanStack Query versions

04Context-aware refactoring based on specific library best-practice documentation

05Automated verification loop that runs builds and tests before finalizing changes

060 GitHub stars

使用场景

01Modernizing legacy React components to follow React 19 and Next.js 15 patterns

02Automating the refactoring of data fetching logic to comply with TanStack Query v5

03Enforcing consistent state management patterns across large Zustand-based projects

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add flosrn/.claude workflow-clean-code

For use in Claude.ai and ChatGPT