Skip to content
Skills Library
Programming · Review & audit

rubycritic

/rubycritic

Integrate RubyCritic to analyze Ruby code quality and maintain high standards throughout development. Use when working on Ruby projects to check code smells, complexity, and duplication. Triggers include creating/editing Ruby files, refactoring code, reviewing code quality, or when user requests code analysis or quality checks.

Repository
ai-context ↗
Licence
MIT
Last repository change
21.07.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
6
Scripts
1
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 21.07.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 1 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/check_quality.sh

What it does and when to use it

Integrate RubyCritic to analyze Ruby code quality and maintain high standards throughout development. Use when working on Ruby projects to check code smells, complexity, and duplication. Triggers include creating/editing Ruby files, refactoring code, reviewing code quality, or when user requests code analysis or quality checks.

Original author description

Integrate RubyCritic to analyze Ruby code quality and maintain high standards throughout development. Use when working on Ruby projects to check code smells, complexity, and duplication. Triggers include creating/editing Ruby files, refactoring code, reviewing code quality, or when user requests code analysis or quality checks.

How it works

  1. Quick Start
  2. Workflow
  3. Interpreting Results
  4. Responding to Issues
  5. References
Original SKILL.md headings · 54 lines, 207 words
SKILL.md preview
---
name: rubycritic
description: Integrate RubyCritic to analyze Ruby code quality and maintain high standards throughout development. Use when working on Ruby projects to check code smells, complexity, and duplication. Triggers include creating/editing Ruby files, refactoring code, reviewing code quality, or when user requests code analysis or quality checks.
---

# RubyCritic Code Quality Analysis

## Quick Start

Run quality check on Ruby files:

```bash
scripts/check_quality.sh [path/to/ruby/files]
```

Analyzes the current directory if no path provided. Auto-installs RubyCritic if missing.

Check recently modified files:

```bash
scripts/check_quality.sh $(git diff --name-only | grep '\.rb$')
```

## Workflow

Run RubyCritic automatically:
- After creating new Ruby files or classes
- After implementing complex methods (>10 lines)
- After refactoring existing code
- Before marking tasks as complete

**Skip for**: simple variable renames, comment changes, minor formatting.

## Interpreting Results

- **Score 90+**: Good. Score 95+ is excellent.
- **Score 80-89**: Consider refactoring.
- **Below 80**: Prioritize improvements.
- **File ratings**: A/B acceptable, C needs attention, D/F requires refactoring.

RubyCritic combines three analyzers:
- **Reek** (code smells) - design and readability issues
- **Flog** (complexity) - overly complex methods
- **Flay** (duplication) - repeated code patterns

## Responding to Issues

Fix in priority order: high complexity > duplication > code smells > style.

Fix one issue at a time, re-run after each fix, verify score improves.

## References

- [references/code_smells.md](references/code_smells.md) - Common smells with before/after examples
- [references/configuration.md](references/configuration.md) - `.rubycritic.yml` options, CI mode, score calculation
- [references/git-hooks.md](references/git-hooks.md) - Pre-commit hooks and CI/CD integration
- [references/error-handling.md](references/error-handling.md) - Troubleshooting installation and analysis errors
Files in this package (6)
  • SKILL.md 2 KB
  • references/code_smells.md 3 KB
  • references/configuration.md 2 KB
  • references/error-handling.md 2 KB
  • references/git-hooks.md 2 KB
  • scripts/check_quality.sh 4 KB

Versions

The database has no other skills named rubycritic.

Database snapshot: 13.11.2026 · package version 4036251ddf16 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100review-ruby-code
    Comprehensive Ruby and Rails code review using Sandi Metz rules and SOLID principles. Analyzes changed files in current branch vs base branch, runs rubycritic and simplecov, identifies OOP violations, Rails anti-patterns, security issues, code smells, and test coverage gaps.…
  • 100ruby-refactor
    Ruby refactoring guidelines from community best practices. This skill should be used when refactoring, reviewing, or restructuring Ruby code to improve design, readability, and maintainability. Triggers on tasks involving code smells, method extraction, conditional…
  • 100simplecov
    Comprehensive test coverage analysis and improvement for Ruby and Rails applications using SimpleCov and SimpleCov Console formatter. Automatically runs coverage reports, identifies gaps, suggests tests, and enforces coverage standards. Integrates with RubyCritic for holistic…
  • 100checking-code-quality
    Checks code quality metrics including complexity, duplication, naming conventions, and function length. Use when running quality gates, reviewing code smells, or checking lint rules. Automatically triggered on complex modules or post-refactor.
  • 100code-quality
    Run comprehensive code quality analysis: cyclomatic complexity, code smells, SOLID principle violations, dead code detection, duplication analysis, and maintainability scoring. Use when reviewing code quality, conducting code audits, checking technical debt, analyzing complexity…
  • 100ruby
    This skill should be used when writing or reviewing Ruby code, or when the project uses "Ruby", "RSpec", "service objects", "Struct", "Data class", or Ruby class/module patterns. Provides Ruby coding conventions, patterns, and best practices. Project-specific conventions always take priority.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.