⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
rails-conventions
Rails 8.x application architecture, implementation, and review guidance for production codebases. Use when building or reviewing Ruby on Rails 8 features across models, controllers, routes, Hotwire, jobs, APIs, performance, security, and testing. Trigger for requests mentioning Rails 8, Active Record, Active Job, GoodJob, Solid Queue, Turbo/Stimulus, REST resources, migrations, code quality, naming, and production readiness.
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
// README
What this skill helps with
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
- write value-based tests split by responsibility (deep unit coverage, thin request checks)
- generate migrations and installer files instead of inventing them
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 (including realtime posture)
- Background jobs (adapter detection + backend-specific guidance)
- Webhook inbound/outbound delivery reliability
- Performance and caching strategy
- Security checklist (including SSRF hardening and tenancy)
- Testing strategy (value-based assertions, Minitest and Minitest::Mock)
- API and serialization conventions
- Optional 37signals-inspired profile
- Generator-owned files policy (migrations, installers — never invent them)
Validate, install, and update
Run the bundled validation script before publishing changes:
ruby scripts/validate_skill.rb
Install 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-conventions
Forward-test prompts
Use 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.
Add a request test for closing a card: assert redirect, h1, and that the card is closed — do not scrape the whole page. Cover edge cases in the model test.
Generate a migration to add postponed_at to cards. Do not invent the timestamp filename by hand.
References
- Agent Skills spec: https://agentskills.io
- Heavily inspired by: https://github.com/marckohlbrugge/unofficial-37signals-coding-style-guide
License
MIT.
About
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.
// HOW IT'S BUILT
KEY FILES