rails-conventions
Build and review Rails 8 code by matching the codebase you already have, not by forcing generic patterns that don’t fit your app.
rails-conventions is for real production work in Rails codebases where consistency matters.
It guides agents to:
- inspect local patterns first (models, controllers, routes, tests, deploy setup)
- keep naming and architecture aligned with existing conventions
- write backend-aware job code (
good_joborsolid_queue) without assumptions - catch risks early in security, performance, and test coverage
- Rails 8 baseline and compatibility constraints
- Naming, layering, and code organization
- Active Record modeling, PostgreSQL features, and migration discipline
- Controllers, params, and response semantics
- REST/resource-focused routing
- Hotwire/Turbo/Stimulus patterns
- Background jobs (adapter detection + backend-specific guidance)
- Performance and caching strategy
- Security checklist
- Testing strategy (Minitest and Minitest::Mock)
- API and serialization conventions
- Optional 37signals-inspired profile
Run the bundled validation script before publishing changes:
ruby scripts/validate_skill.rbInstall or update the skill with skills:
# install from source
npx skills add [email protected]:ethos-link/rails-conventions.git --skill rails-conventions
# update an existing install
npx skills update rails-conventionsUse these prompts to check that the skill triggers correctly and loads only the references needed for the task:
Implement a new billing webhook endpoint in this Rails app, matching existing conventions and tests.
Review this Rails 8 pull request for production readiness, focusing on naming, data integrity, security, and missing tests.
This Rails app uses GoodJob. Add a background job for exporting account reports without changing the queue backend.
- Agent Skills spec: https://agentskills.io
- Heavily inspired by: https://github.com/marckohlbrugge/unofficial-37signals-coding-style-guide
MIT.
Made by the team at Ethos Link — practical software for growing businesses. We build tools for hospitality operators who need clear workflows, fast onboarding, and real human support.
We also build Reviato, “Capture. Interpret. Act.”. Turn guest feedback into clear next steps for your team. Collect private appraisals, spot patterns across reviews, and act before small issues turn into public ones.