rails-expert

Rails 7+ specialist that optimizes Active Record queries with includes/eager_load, implements Turbo Frames and Turbo Streams for partial page updates, configures Action Cable for WebSocket connections, sets up Sidekiq workers for background job processing, and writes comprehensive RSpec test suites. Use when building Rails 7+ web applications with Hotwire, real-time features, or background job processing. Invoke for Active Record optimization, Turbo Frames/Streams, Action Cable, Sidekiq, RSpec Rails.

Quality

88%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Passed

No known issues

Quality

Content

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a solid Rails skill with strong actionability and clear workflow sequencing including validation checkpoints and error recovery paths. The main weaknesses are the inclusion of some patterns Claude already knows well (strong parameters, basic controller conventions) which inflate token usage, and the reference files listed in the progressive disclosure table don't exist in the bundle, undermining the otherwise good organizational structure.

Suggestions

Remove the Strong Parameters controller template section — Claude knows standard Rails controller patterns; focus inline examples on less obvious patterns like Turbo Frames and Sidekiq error handling.

Create the referenced bundle files (references/hotwire-turbo.md, references/active-record.md, etc.) or remove the reference table to avoid pointing to non-existent files.

Move the N+1 prevention and Turbo Frame examples into the reference files and keep only a brief summary inline to improve progressive disclosure and reduce SKILL.md length.

Dimension	Reasoning	Score
Conciseness	The skill is mostly efficient with good code examples, but includes some patterns Claude already knows well (strong parameters, basic controller template) and the constraints section restates Rails best practices that are common knowledge for Claude. The strong parameters template in particular adds bulk without novel value.	2 / 3
Actionability	Provides fully executable, copy-paste ready code examples for N+1 prevention, Turbo Frames, Sidekiq workers, and controller templates. Commands like `rails generate`, `rails db:migrate`, `bundle exec rspec` are specific and concrete. The output templates section clearly specifies deliverables.	3 / 3
Workflow Clarity	The core workflow is clearly sequenced with explicit validation checkpoints (step 3 has rollback/retry on migration failure, step 5 has rspec pass requirement with error recovery guidance, step 6 covers optimization). Feedback loops are present for migration failures, spec failures, and N+1 detection.	3 / 3
Progressive Disclosure	The reference table with 5 topic-specific files is well-structured with clear 'Load When' guidance, but no bundle files were provided, meaning the referenced files (references/hotwire-turbo.md, etc.) don't actually exist. Additionally, the inline common patterns section is fairly long and some of it (strong parameters, basic controller) could be in reference files instead.	2 / 3
	Total	10 / 12 Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is an excellent skill description that clearly articulates specific capabilities across multiple Rails 7+ technologies, includes abundant natural trigger terms that developers would use, and explicitly states both what the skill does and when to invoke it. The description is well-structured, uses third person voice appropriately, and carves out a distinct niche that minimizes conflict risk with other skills.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions: optimizing Active Record queries with includes/eager_load, implementing Turbo Frames and Turbo Streams, configuring Action Cable for WebSocket connections, setting up Sidekiq workers, and writing RSpec test suites.	3 / 3
Completeness	Clearly answers both 'what' (optimizes queries, implements Turbo, configures Action Cable, sets up Sidekiq, writes RSpec tests) and 'when' with explicit triggers ('Use when building Rails 7+ web applications with Hotwire, real-time features, or background job processing. Invoke for Active Record optimization, Turbo Frames/Streams, Action Cable, Sidekiq, RSpec Rails.').	3 / 3
Trigger Term Quality	Excellent coverage of natural terms users would say: Rails 7+, Active Record, includes/eager_load, Turbo Frames, Turbo Streams, Hotwire, Action Cable, WebSocket, Sidekiq, background jobs, RSpec. These are all terms a developer would naturally use when seeking help with these technologies.	3 / 3
Distinctiveness Conflict Risk	Highly distinctive with a clear niche: Rails 7+ with specific technologies (Hotwire, Action Cable, Sidekiq, RSpec). The combination of these specific frameworks and the version constraint (Rails 7+) makes it very unlikely to conflict with other skills.	3 / 3
	Total	12 / 12 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository: Jeffallan/claude-skills
Commit: e8be415

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.