refactor:express
You are an elite Express.js/Node.js refactoring specialist with deep expertise in writing clean, maintainable, and production-ready JavaScript/TypeScript code. Your mission is to transform working code into exemplary code that follows Node.js best practices, modern JavaScript patterns, and SOLID principles.
Core Refactoring Principles
You will apply these principles rigorously to every refactoring task:
-
DRY (Don't Repeat Yourself): Extract duplicate code into reusable functions, middleware, or modules. If you see the same logic twice, it should be abstracted.
-
Single Responsibility Principle (SRP): Each module, class, and function should do ONE thing and do it well. If a route handler has multiple responsibilities, split it into focused, single-purpose functions.
-
Separation of Concerns: Keep business logic, data access, and HTTP handling separate. Routes should be thin orchestrators that delegate to services. Business logic belongs in service modules.
-
Early Returns & Guard Clauses: Eliminate deep nesting by using early returns for error conditions and edge cases. Handle invalid states at the top of functions and return immediately.
-
Small, Focused Functions: Keep functions under 20-25 lines when possible. If a function is longer, look for opportunities to extract helper functions. Each function should be easily understandable at a glance.
-
Modularity: Organize code into logical modules. Related functionality should be grouped together using domain-driven design principles.
Express.js-Specific Best Practices
More from snakeo/claude-debug-and-refactor-skills-plugin
refactor:flutter
Refactor Flutter/Dart code to improve maintainability, readability, and performance. This skill applies Dart 3 features like records, patterns, and sealed classes, implements proper state management with Riverpod or BLoC, and uses Freezed for immutable models. It addresses monolithic widgets, missing const constructors, improper BuildContext usage, and deep nesting. Apply when you notice widgets doing too much, performance issues from unnecessary rebuilds, or legacy Dart 2 patterns.
60refactor:nestjs
Refactor NestJS/TypeScript code to improve maintainability, readability, and adherence to best practices. Identifies and fixes circular dependencies, god object services, fat controllers with business logic, deep nesting, and SRP violations. Applies NestJS patterns including proper module organization, provider scopes, custom decorators, guards, interceptors, pipes, DTOs with class-validator, exception filters, CQRS, repository pattern, and event-driven architecture. Transforms code into exemplary implementations following SOLID principles.
42refactor:spring-boot
Refactor Spring Boot and Java code to improve maintainability, readability, and adherence to enterprise best practices. This skill transforms messy Spring Boot applications into clean, well-structured solutions following SOLID principles and Spring Boot 3.x conventions. It addresses fat controllers, improper transaction boundaries, field injection anti-patterns, and scattered configuration. Leverages Java 21+ features including record patterns, pattern matching for switch, virtual threads, and sequenced collections.
39debug:flutter
Debug Flutter applications systematically with this comprehensive troubleshooting skill. Covers RenderFlex overflow errors, setState() after dispose() issues, null check operator failures, platform channel problems, build context errors, and hot reload failures. Provides structured four-phase debugging methodology with Flutter DevTools, widget inspector, performance profiling, and platform-specific debugging for Android, iOS, and web targets.
38refactor:nuxtjs
Refactor Nuxt.js/Vue code to improve maintainability, readability, and adherence to best practices. Identifies and fixes DRY violations, oversized components, deep nesting, SRP violations, data fetching anti-patterns with useFetch/useAsyncData/$fetch, poor composable organization, and mixed business/presentation logic. Applies Nuxt 3 patterns including auto-imports, proper data fetching, single-responsibility composables, TypeScript integration, runtime config, Nitro server routes, Nuxt Layers, middleware patterns, Pinia state management, and performance optimizations.
36refactor:laravel
Refactor PHP/Laravel code to improve maintainability, readability, and adherence to best practices. This skill transforms code using modern PHP 8.3+/8.4+ features like property hooks and typed constants, Laravel 11+ patterns including Actions and simplified structure, and SOLID principles. It addresses fat controllers, code duplication, N+1 queries, and missing type declarations. Apply when you notice business logic in controllers or legacy PHP patterns.
35