How do I install the Rubycritic skill?

Run npx skillmds@latest add tomevault-io/rubycritic in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Rubycritic safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Rubycritic?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Rubycritic free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Rubycritic?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Rubycritic by tomevault-io — Agent Skill

Name: Rubycritic
Author: tomevault-io

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. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

RubyCritic Code Quality Analysis

Quick Start

Run quality check on Ruby files:

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:

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 - Common smells with before/after examples
references/configuration.md - .rubycritic.yml options, CI mode, score calculation
references/git-hooks.md - Pre-commit hooks and CI/CD integration
references/error-handling.md - Troubleshooting installation and analysis errors

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: rubycriticdescription: 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. Use when this capability is needed.---# RubyCritic Code Quality Analysis## Quick StartRun quality check on Ruby files:```bashscripts/check_quality.sh [path/to/ruby/files]```Analyzes the current directory if no path provided. Auto-installs RubyCritic if missing.Check recently modified files:```bashscripts/check_quality.sh $(git diff --name-only | grep '\.rb$')```## WorkflowRun 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 IssuesFix 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---> Converted and distributed by [TomeVault](https://tomevault.io/claim/el-feo) — claim your Tome and manage your conversions.

Frequently asked questions