React Refactor
Architectural refactoring guide for React applications covering component architecture, state architecture, hook patterns, component decomposition, coupling and cohesion, data flow, and refactoring safety. Use when refactoring React codebases, reviewing PRs for architectural issues, decomposing oversized components, or improving module boundaries. Does NOT cover React 19 API usage (see react skill) or performance optimization (see react-optimise skill).
Install
npx skills add pproenca/dot-skills --skill react-refactorgit clone --depth 1 https://github.com/pproenca/dot-skills.git /tmp/dot-skills
mkdir -p ~/.claude/skills
cp -r /tmp/dot-skills/skills/.experimental/react-refactor ~/.claude/skills/react-refactorPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# React Refactor Best Practices Architectural refactoring guide for React applications. Contains 40 rules across 7 categories, prioritized by impact from critical (component and state architecture) to incremental (refactoring safety). ## When to Apply - Refactoring existing React codebases or planning large-scale restructuring - Reviewing PRs for architectural issues and code smells - Decomposing oversized components into focused units - Extracting reusable hooks from component logic - Improving testability of React code - Reducing coupling between feature modules ## Rule Categories | Category | Impact | Rules | Key Topics | |----------|--------|-------|------------| | Component Architecture | CRITICAL | 8 | Compound components, headless pattern, composition over props, client boundaries | | State Architecture | CRITICAL | 7 | Colocation, state machines, URL state, derived values | | Hook Patterns | HIGH | 6 | Single responsibility, naming, dependency stability, composition | | Component Decomposition | HIGH | 6 | Scroll test, extraction by change reason, view/logic separation | | Coupling & Cohesion | MEDIUM | 4 | Dependency injection, circular deps, stable imports, barrel-free | | Data & Side Effects | MEDIUM | 4 | Server-first fetch, TanStack Query, error boundaries | | Refactoring Safety | LOW-MEDIUM | 5 | Characterization tests, behavior testing, integration tests | ## Quick Reference **Critical patterns** — get these right first:
Details
- Skill name
react-refactor- Repository
- pproenca/dot-skills
- Path
skills/.experimental/react-refactor/SKILL.md- License
- MIT
- Repo updated
- 15 August 2026
FAQ
What does the React Refactor skill do?
Architectural refactoring guide for React applications covering component architecture, state architecture, hook patterns, component decomposition, coupling and cohesion, data flow, and refactoring safety. Use when refactoring React codebases, reviewing PRs for architectural issues, decomposing oversized components, or improving module boundaries. Does NOT cover React 19 API usage (see react skill) or performance optimization (see react-optimise skill).
How do I install the React Refactor skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add pproenca/dot-skills --skill react-refactor. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is React Refactor popular?
It lives in pproenca/dot-skills, which has 228 GitHub stars and 19 forks.
Related skills
12 Factor App
228pproenca/dot-skills
The Twelve-Factor App methodology for building scalable, maintainable cloud-native applications. Use when designing backend services, APIs, microservices, or any software-as-a-service application. Triggers on deployment patterns, configuration management, process architecture, logging, and infrastructure decisions.
37signals Rails
228pproenca/dot-skills
37signals Rails coding principles and conventions from DHH, Jorge Manrubia, and the Fizzy/Basecamp/HEY codebase. This skill should be used when writing, reviewing, or refactoring Ruby on Rails code following the 37signals philosophy — vanilla Rails, CRUD controllers, rich domain models, concerns, no service objects, Hotwire, Turbo, Stimulus, Solid Queue, Solid Cache, Solid Cable, multi-tenancy, Minitest, custom auth, or DHH conventions.
Acceptance Pipeline Catalog
228pproenca/dot-skills
Use when implementing, reviewing, or debugging a Gherkin acceptance-test pipeline with mutation testing. Covers parser, JSON IR, generator, runtime, step handlers, test runner, mutator, value mutation rules, execution, result classification, reporting, project layout, conformance, and agent setup. Based on Uncle Bob's Acceptance Pipeline Specification. Trigger even when the user mentions Gherkin parsing, acceptance test generation, mutation testing for acceptance tests, or building a portable test pipeline.
Resilient Computer Use
201swyxio/skills
Operate desktop applications and browsers reliably through Computer Use, with proactive state tracking and recovery from common automation failures. Use for any multi-step or consequential UI workflow, especially when app focus moves, multiple monitors or windows are present, accessibility state is empty or stale, element indices change, screenshots and accessibility disagree, dialogs or file pickers appear, a browser upload chooser or native picker fails, a local artifact is prepared but not attached, buttons remain disabled, typing submits unexpectedly, a user interrupts or concurrently uses
React Pwa
191jwynia/agent-skills
Build Progressive Web Apps with React and Vite. This skill should be used when the user asks to "create a PWA", "add offline support", "make app installable", "generate service worker", "configure workbox", "add push notifications", or mentions PWA, progressive web app, or offline-first development. Keywords: PWA, progressive web app, service worker, manifest, offline, installable, workbox, vite-plugin-pwa, React.
Scene Sequencing
191jwynia/agent-skills
Structure scenes and control pacing using scene-sequel rhythm. Use when individual scenes work but don't accumulate, when pacing feels off (too rushed or too slow), when transitions feel mechanical, or when readers can follow but aren't compelled forward. Based on Dwight Swain's Goal-Conflict-Disaster and Reaction-Dilemma-Decision structure.
Browse the most popular Claude skills, all frontend & design skills, or write your own with the skills generator.