CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

76

Quality

95%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

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

An exemplary content body: a validated six-step workflow with error-recovery loops, copy-paste-ready code for the most common Rails patterns, and a well-signaled one-level-deep reference structure. The only trim available is the boilerplate Strong Parameters controller template, which is standard Rails knowledge Claude already has.

Suggestions

Trim or shorten the 'Strong Parameters (controller template)' section to just the post_params permit pattern — the full CRUD controller scaffold is standard Rails Claude already generates, and it is the one block that doesn't earn its tokens.

DimensionReasoningScore

Conciseness

The workflow, N+1 patterns (includes vs eager_load distinction), and Sidekiq template (retry: 3, dead: false, don't re-raise RecordNotFound) convey non-obvious project conventions that earn their tokens. However, the ~25-line Strong Parameters controller template is standard Rails that Claude already generates unaided — a minor instance of over-explanation that could be trimmed. Not 5 because of that boilerplate; not 3 because the rest is efficient and assumes competence.

4 / 5

Actionability

Fully executable throughout: concrete commands ("rails generate model User name:string email:string", "rails db:migrate", "bundle exec rspec", "bundle exec rubocop") and copy-paste-ready code blocks with real file paths (app/views/posts/index.html.erb, app/jobs/send_welcome_email_job.rb, app/controllers/posts_controller.rb) covering the common cases for each sub-domain. Not 4: no gaps in the guidance — Action Cable and RSpec detail is explicitly delegated to reference files rather than left vague.

5 / 5

Workflow Clarity

The six-step Core Workflow has a clear sequence with explicit validation checkpoints ("must pass" for rspec, rubocop for style, schema verification via db:schema:dump) and genuine feedback loops: migration failure → inspect db/schema.rb → db:rollback → fix and retry, and spec failure → fix examples → re-run with --format documentation, plus N+1 remediation during review. Matches the anchor-5 example of validate-fix-retry loops.

5 / 5

Progressive Disclosure

The Reference Guide table (Topic | Reference | Load When) cleanly signals all five one-level-deep references, all of which exist on disk and contain no further nested .md references. The body stays a lean overview with only high-frequency patterns inline, matching the anchor-5 structure of well-signaled, appropriately split content.

5 / 5

Total

19

/

20

Passed

Description

96%Weight 40%Scale 1-5

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

A strong description: third-person voice, five concrete capability statements each naming the specific technique, and both an explicit 'Use when' clause and an 'Invoke for' trigger list. The only weakness is that the Active Record optimization trigger could collide with a general database-optimizer skill in the same environment.

DimensionReasoningScore

Specificity

Lists five concrete, technique-specific actions — "optimizes Active Record queries with includes/eager_load", "implements Turbo Frames and Turbo Streams", "configures Action Cable for WebSocket connections", "sets up Sidekiq workers", "writes comprehensive RSpec test suites" — comprehensively covering the skill's claimed domains. Not 4: the coverage leaves no minor gaps; each action names the concrete mechanism.

5 / 5

Completeness

Explicitly answers both questions: what (five named capabilities with techniques) and when ("Use when building Rails 7+ web applications with Hotwire, real-time features, or background job processing" plus "Invoke for Active Record optimization, Turbo Frames/Streams, Action Cable, Sidekiq, RSpec Rails"). Matches the anchor-5 example structure of concrete what + explicit trigger phrases.

5 / 5

Trigger Term Quality

Covers the natural vocabulary Rails developers actually use across every sub-domain: "Rails 7+", "Hotwire", "Turbo Frames", "Turbo Streams", "Action Cable", "Active Record", "Sidekiq", "RSpec Rails", "background job processing", "real-time features". Not 4: no meaningful natural synonym is missing — these terms plus the 'Use when'/'Invoke for' phrasing capture how users would ask.

5 / 5

Distinctiveness Conflict Risk

Action Cable, Turbo Frames, Sidekiq, and RSpec Rails are unambiguously Rails-only triggers with minimal conflict risk, but "optimizes Active Record queries" / "Invoke for Active Record optimization" overlaps a generic database-optimizer skill (which the metadata itself lists as related-skills). Anchor 4 ("mostly distinct; minor overlap risk with closely related skills") fits better than 5 because that one capability could fire the wrong skill.

4 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

Jeffallan/claude-skills

Path

skills/rails-expert/SKILL.md

Reviewed

Table of Contents

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.