Ruby Refactor
This is a comprehensive Ruby refactoring reference with 45 community-sourced rules organized by impact level, from critical structure changes down to naming conventions. You'd reach for it when extracting bloated methods, flattening nested conditionals, or modernizing code to Ruby 3.x patterns. The prioritization system is smart: it ranks guard clauses and method extraction as critical while keeping stylistic stuff like endless methods further down. Each rule links to detailed examples with before/after code. What I like is the focus on practical smells like feature envy and primitive obsession rather than abstract principles. It's essentially a decision tree for "I know this code is bad, but what specific refactoring should I apply?"
- skills.sh installs
- 299
- GitHub stars
- 222
- last updated
- Aug 21, 2026
Install
$ npx -y skills add pproenca/dot-skills --skill ruby-refactor --agent claude-codeInstalls into .claude/skills of the current project.
Files
Community Ruby Refactoring Best Practices
Comprehensive refactoring guide for Ruby applications, maintained by the community. Contains 45 rules across 8 categories, prioritized by impact to guide automated refactoring and code generation.
When to Apply
Reference these guidelines when:
- Refactoring Ruby code to reduce complexity and improve design
- Extracting methods, classes, or value objects from large units
- Simplifying complex conditionals and deep nesting
- Reducing coupling between classes and modules
- Adopting idiomatic Ruby patterns and modern Ruby 3.x features
Rule Categories by Priority
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | Structure & Decomposition | CRITICAL | struct- |
| 2 | Conditional Simplification | CRITICAL | cond- |
| 3 | Coupling & Dependencies | HIGH | couple- |
| 4 | Ruby Idioms | HIGH | idiom- |
| 5 | Data & Value Objects | MEDIUM-HIGH | data- |
| 6 | Design Patterns | MEDIUM | pattern- |
| 7 | Modern Ruby 3.x | MEDIUM | modern- |
| 8 | Naming & Readability | LOW-MEDIUM | name- |
Quick Reference
1. Structure & Decomposition (CRITICAL)
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/pproenca/dot-skills
- Categories
- Code Review & Quality, Design & UI/UX
- First seen
- Jun 3, 2026
More from pproenca/dot-skills
All 100- Ios Xcode298
- Restful Hateoas298
- Rails Dev293
- Ios Ui Refactor291
- Ruby Optimise286
- Swift Optimise285
- Ios Testing281
- Swift Refactor281
- Dev Rfc279
- Swift Ui Architect273
- Ios Taste272
- Ios Storyboard270
- Rails Design System270
- Swift Data268
- Ios Chaos Monkey267
- Ios Navigation267
- Nginx C Module Perf260
- React Native Elements258
- Effect Ts257
- Bug Review256
- Nginx C Module Debug253
- Rails Application Ui Blocks251
- Rust Write Tests248
- Rust Implement246
Recommended
More Code Review & Quality
project-architectersinkoc/project-architectDocumentation-first project planning that produces implementation-ready blueprints and single-shot coding agent prompts. Generates 4 interconnected docs — SPECI261skills.sh installs
web-quality-auditdavila7/claude-code-templatesComprehensive web quality audit covering performance, accessibility, SEO, and best practices. Use when asked to "audit my site", "review web quality", "run ligh232skills.sh installs
pr-review-assistantrysweet/amplihackPhilosophy-aware PR reviews checking alignment with amplihack principles. Use when reviewing PRs to ensure ruthless simplicity, modular design, and zero-BS impl225skills.sh installs
anthropic-architectjamesrochabrun/skillsDetermine the best Anthropic architecture for your project by analyzing requirements and recommending the optimal combination of Skills, Agents, Prompts, and SD216skills.sh installs
gemini-peer-reviewjezweb/claude-skillsGet a second opinion from Gemini on code, architecture, debugging, or security. Uses direct Gemini API calls — no CLI dependencies. Trigger with 'ask gemini', '200skills.sh installs
code-review-expertpersonamanagmentlayer/pclExpert-level code review focusing on quality, security, performance, and maintainability. Use this skill for conducting thorough code reviews, identifying issue189skills.sh installs