RubyCritic Skill for Claude Code
A Claude Code skill that provides comprehensive code quality analysis for Ruby and Rails projects using RubyCritic.
Features
- 🔍 Code Quality Analysis - Get detailed metrics on complexity, duplication, and code smells
- 📊 Multiple Analysis Types - Full analysis, summaries, worst files, and branch comparisons
- 🎯 Rails-Aware - Specific guidance for models, controllers, services, and concerns
- ⚡ Model-Invoked - Claude automatically knows when and how to use RubyCritic
- 📈 Track Progress - Compare quality across branches and commits
Installation
Option 1: Plugin Installation (Recommended)
Install via Claude Code's plugin system for automatic updates:
# Add this repository as a marketplace
/plugin marketplace add esparkman/claude-rubycritic-skill
# Install the plugin
/plugin install rubycritic-skill@rubycritic-skill
# Install RubyCritic gem
gem install rubycritic
Option 2: Manual Installation
# Clone the repository
git clone https://github.com/esparkman/claude-rubycritic-skill.git
cd claude-rubycritic-skill
# Run the install script
./install.sh
Or manually:
# Clone to temporary location
git clone https://github.com/esparkman/claude-rubycritic-skill.git /tmp/rubycritic-temp
# Copy the skill folder
mkdir -p ~/.claude/skills
cp -r /tmp/rubycritic-temp/skills/rubycritic-skill ~/.claude/skills/
# Install RubyCritic gem
gem install rubycritic
# Clean up
rm -rf /tmp/rubycritic-temp
For detailed installation instructions, see INSTALLATION.md.
Usage
This is a model-invoked skill - Claude automatically knows when to use it based on your requests. Navigate to any Ruby or Rails project in Claude Code and simply ask in natural language:
Analyze entire project:
Analyze the code quality of this project
Analyze specific paths:
Check the code quality of app/models
Run code quality analysis on app/controllers/users_controller.rb
Get a summary:
Give me a quick summary of the code quality metrics
Find worst files:
Show me the 5 worst files that need refactoring
What files have the lowest quality scores?
Compare branches:
Compare the code quality between this branch and main
How has code quality changed since the main branch?
Claude will automatically invoke RubyCritic and provide detailed analysis with actionable insights.
Available Capabilities
The skill provides several types of analysis you can request:
| Capability | What to Ask | What You Get |
|---|---|---|
| Full Analysis | "Analyze the code quality of [path]" | Complete breakdown of metrics, scores, and smells for files |
| Summary | "Give me a code quality summary" | Quick overview of overall project health without file details |
| Worst Files | "Show me the worst files" or "Find the 5 lowest scoring files" | Prioritized list of files needing immediate attention |
| Branch Comparison | "Compare code quality with main branch" | Diff showing quality improvements or regressions between branches |
What Claude Can Do
When you ask about code quality, Claude will:
- Run RubyCritic analysis on your specified files or directories
- Provide detailed metrics on complexity, duplication, and code smells
- Explain what the scores mean and why they matter
- Suggest specific refactorings for identified issues
- Compare quality across branches
- Prioritize high-impact files that need attention
Understanding the Results
Score Grades:
- A (90-100): Excellent - minimal issues
- B (80-89): Good - minor improvements needed
- C (70-79): Fair - consider refactoring
- D (60-69): Poor - refactoring recommended
- F (<60): Critical - immediate attention required
Key Metrics:
- Churn: How frequently files change (high churn + low quality = priority)
- Complexity: Cyclomatic complexity (aim for < 10 per method)
- Duplication: Code duplication percentage (aim for < 5%)
- Smells: Code smell count by type (Long Method, Feature Envy, etc.)