igmarin/rails-agent-skills
Curated library of 42 public AI agent skills for Ruby on Rails development, plus 5 callable workflow skills. Organized by category: planning, testing, code-quality, ddd, engines, infrastructure, api, patterns, context, orchestration, and workflows. Covers code review, architecture, security, testing (RSpec), engines, service objects, DDD patterns, and TDD automation.
97
Quality
97%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Securityby
Passed
No known issues
skill-catalog.mddocs/reference/
Skill Catalog — Rails Agent Skills
Complete catalog of 39 skills organized by development lifecycle stage and by category.
Quick Navigation
By Stage: 00 — Discovery · 10 — Planning · 30 — Development · 40 — Quality · 50 — Review · 60 — Engines
By Category: API · Context · Code Quality · DDD · Engines · Infrastructure · Orchestration · Patterns · Planning · Testing · Workflows
Index by Stage
- 00 — Discovery & Context
- 10 — Planning & Design
- 20 — Setup & Configuration
- 30 — Development
- 40 — Code Quality
- 50 — Review & Validation
- 60 — Engines
00 — Discovery & Context
| Skill | Description | Trigger Words |
|---|---|---|
| rails-context-engineering | Load minimum context before coding (schema, routes, neighbors) | "load context", "before I code", "match existing style", "what does this codebase use" |
| rails-project-onboarding (NEW) | Complete dev environment setup (Docker, env vars, db) | "onboarding", "new dev", "setup project", "Docker", "environment" |
10 — Planning & Design
| Skill | Description | Trigger Words |
|---|---|---|
| create-prd | Generate PRD with goals, user stories, requirements | "plan feature", "create PRD", "requirements", "feature spec" |
| generate-tasks | Convert PRD into TDD-ready tasks with exact paths | "break into tasks", "implementation plan", "task list", "generate tasks" |
| ticket-planning | Create tickets in issue tracker from plan | "create tickets", "Jira", "Linear", "GitHub Issues" |
| ddd-ubiquitous-language | Domain terms glossary | "domain terms", "ubiquitous language", "what should we call this", "naming" |
| ddd-boundaries-review | Review bounded contexts and language leakage | "context boundaries", "language leakage", "ownership", "cross-context" |
| ddd-rails-modeling | Map DDD to Rails (models, services, VO) | "aggregate", "value object", "domain event", "repository", "DDD" |
20 — Setup & Configuration
No shipped skills in this stage yet. See Roadmap for rails-ci-cd-setup.
30 — Development
| Skill | Description | Trigger Words |
|---|---|---|
| rails-tdd-slices | Choose the best first failing spec | "where to start testing", "what test first", "TDD", "first failing spec" |
| rspec-best-practices | TDD discipline, spec types, factory design | "write test", "RSpec", "test-driven", "spec type" |
| rspec-service-testing | Service object specific testing | "test service", "spec/services", "service spec" |
| ruby-service-objects | .call pattern, response contract, YARD | "create service", "extract service", ".call", "service object" |
| ruby-api-client-integration | Layered architecture for external APIs | "API integration", "HTTP client", "external API", "third party" |
| rails-background-jobs | Active Job, Solid Queue, Sidekiq, idempotency | "background job", "Active Job", "async", "Sidekiq", "worker" |
| rails-migration-safety | Safe migrations for production | "migration", "add column", "index", "backfill", "zero-downtime" |
| rails-graphql-best-practices | Schema design, N+1 prevention, auth | "GraphQL", "resolver", "mutation", "dataloader" |
| rails-bug-triage | Bug diagnosis and reproduction | "bug", "debug", "fix", "broken", "error", "regression" |
| rails-authorization-policies (NEW) | Pundit/CanCanCan, roles, permissions | "authorization", "Pundit", "CanCanCan", "roles", "permissions", "policy" |
| rails-performance-optimization (NEW) | N+1s, profiling, caching, query optimization | "N+1", "slow", "performance", "optimize", "caching", "profiling" |
| rails-api-versioning (NEW) | REST API versioning | "API version", "v1", "v2", "versioning", "deprecation" |
| rails-database-seeding (NEW) | Fixtures vs Seeds for dev/test | "seeds", "fixtures", "test data", "development data" |
| rails-frontend-hotwire (NEW) | Turbo/Stimulus integration | "Hotwire", "Turbo", "Stimulus", "SPA", "frames", "streams" |
| strategy-factory-null-calculator | Variant-based calculators | "calculator", "strategy pattern", "factory", "dispatch", "variant" |
40 — Code Quality
| Skill | Description | Trigger Words |
|---|---|---|
| refactor-safely | Refactor preserving behavior | "refactor", "extract", "restructure", "clean up" |
| rails-code-conventions | DRY/YAGNI/PORO/CoC/KISS by path | "code review", "conventions", "clean code", "DRY", "YAGNI" |
| yard-documentation | Inline documentation with YARD | "YARD", "documentation", "@param", "@return", "inline docs" |
| rails-stack-conventions | Stack-specific conventions (PostgreSQL, Hotwire, Tailwind) | "stack", "PostgreSQL", "Hotwire", "Tailwind", "conventions" |
50 — Review & Validation
| Skill | Description | Trigger Words |
|---|---|---|
| rails-code-review | Systematic Rails PR review | "review PR", "code review", "check this code", "CR" |
| rails-review-response | Respond to review feedback | "feedback", "review comments", "address feedback", "respond" |
| rails-security-review | Deep security audit | "security", "audit", "vulnerability", "XSS", "SQL injection", "CSRF" |
| rails-architecture-review | Structural boundary review | "architecture", "structure", "boundaries", "fat model", "extract" |
| api-rest-collection | Generate Postman collections for APIs | "Postman", "API collection", "REST", "test endpoints" |
60 — Engines
| Skill | Description | Trigger Words |
|---|---|---|
| rails-engine-author | Rails engine scaffolding | "create engine", "new engine", "mountable engine" |
| rails-engine-testing | Engine testing setup | "test engine", "dummy app", "engine specs" |
| rails-engine-docs | Engine documentation | "engine README", "install guide", "engine docs" |
| rails-engine-installers | Install generators | "install generator", "engine setup", "copy migrations" |
| rails-engine-reviewer | Complete engine review | "review engine", "engine quality", "engine audit" |
| rails-engine-release | Versioned engine release | "release engine", "version bump", "publish gem", "changelog" |
| rails-engine-compatibility | Cross-version compatibility | "Zeitwerk", "compatibility", "Rails upgrade", "cross-version" |
| rails-engine-extraction | Extract code to engine | "extract to engine", "move feature", "host coupling" |
Skills by Objective (Quick Lookup)
If you need...
| You need... | Recommended Skill(s) |
|---|---|
| Understand codebase | rails-context-engineering |
| New project setup | rails-project-onboarding |
| Plan feature | create-prd → generate-tasks |
| Start coding | rails-tdd-slices → rspec-best-practices |
| Fix bug | rails-bug-triage |
| Refactor | refactor-safely |
| Create service | ruby-service-objects |
| Integrate external API | ruby-api-client-integration |
| Add auth/roles | rails-authorization-policies |
| Optimize performance | rails-performance-optimization |
| Create engine | rails-engine-author |
| Review code | rails-code-review |
| Respond to feedback | rails-review-response |
| Setup CI/CD | (roadmap — rails-ci-cd-setup) |
| Not sure | rails-skills-orchestrator |
Proposed New Skills (Roadmap)
| Skill | Priority | Status |
|---|---|---|
| rails-ci-cd-setup | 🔴 Critical | Not yet implemented |
See also
- Integration Matrix — Which skill connects to which
- Workflows Index — Complete step-by-step flows
- Orchestrator — Entry skill when you don't know which to use
Index by Category
Skills are organized in category folders (skills/<category>/) with frequent entry points at root.
API
| Skill | Path | Description |
|---|---|---|
| api-rest-collection | skills/api/api-rest-collection/ | Generate Postman collections for REST APIs |
| rails-graphql-best-practices | skills/api/rails-graphql-best-practices/ | Schema design, N+1 prevention, auth |
| ruby-api-client-integration | skills/api/ruby-api-client-integration/ | Layered architecture for external APIs |
Context
| Skill | Path | Description |
|---|---|---|
| rails-context-engineering | skills/context/rails-context-engineering/ | Load minimum context before coding |
| rails-project-onboarding | skills/context/rails-project-onboarding/ | Complete dev environment setup |
Code Quality
| Skill | Path | Description |
|---|---|---|
| rails-code-review | skills/code-quality/rails-code-review/ | Systematic Rails PR review |
| rails-review-response | skills/code-quality/rails-review-response/ | Respond to review feedback |
| rails-architecture-review | skills/code-quality/rails-architecture-review/ | Structural boundary review |
| rails-security-review | skills/code-quality/rails-security-review/ | Deep security audit |
| rails-stack-conventions | skills/code-quality/rails-stack-conventions/ | Stack-specific conventions |
| rails-code-conventions | skills/code-quality/rails-code-conventions/ | DRY/YAGNI/PORO/CoC/KISS by path |
| rails-authorization-policies | skills/code-quality/rails-authorization-policies/ | Pundit/CanCanCan, roles, permissions |
| refactor-safely | skills/code-quality/refactor-safely/ | Refactor preserving behavior |
DDD
| Skill | Path | Description |
|---|---|---|
| ddd-ubiquitous-language | skills/ddd/ddd-ubiquitous-language/ | Domain terms glossary |
| ddd-boundaries-review | skills/ddd/ddd-boundaries-review/ | Review bounded contexts |
| ddd-rails-modeling | skills/ddd/ddd-rails-modeling/ | Map DDD to Rails |
Engines
| Skill | Path | Description |
|---|---|---|
| rails-engine-author | skills/engines/rails-engine-author/ | Rails engine scaffolding |
| rails-engine-testing | skills/engines/rails-engine-testing/ | Engine testing setup |
| rails-engine-reviewer | skills/engines/rails-engine-reviewer/ | Complete engine review |
| rails-engine-release | skills/engines/rails-engine-release/ | Versioned engine release |
| rails-engine-docs | skills/engines/rails-engine-docs/ | Engine documentation |
| rails-engine-installers | skills/engines/rails-engine-installers/ | Install generators |
| rails-engine-extraction | skills/engines/rails-engine-extraction/ | Extract code to engine |
| rails-engine-compatibility | skills/engines/rails-engine-compatibility/ | Cross-version compatibility |
Infrastructure
| Skill | Path | Description |
|---|---|---|
| rails-migration-safety | skills/infrastructure/rails-migration-safety/ | Safe migrations for production |
| rails-background-jobs | skills/infrastructure/rails-background-jobs/ | Active Job, Solid Queue, Sidekiq |
| rails-database-seeding | skills/infrastructure/rails-database-seeding/ | Fixtures vs Seeds |
| rails-performance-optimization | skills/infrastructure/rails-performance-optimization/ | N+1s, profiling, caching |
| rails-api-versioning | skills/infrastructure/rails-api-versioning/ | REST API versioning |
| rails-frontend-hotwire | skills/infrastructure/rails-frontend-hotwire/ | Turbo/Stimulus integration |
Orchestration
| Skill | Path | Description |
|---|---|---|
| rails-skills-orchestrator | skills/orchestration/rails-skills-orchestrator/ | Routes to correct specialized skill |
Patterns
| Skill | Path | Description |
|---|---|---|
| ruby-service-objects | skills/patterns/ruby-service-objects/ | .call pattern, response contract |
| strategy-factory-null-calculator | skills/patterns/strategy-factory-null-calculator/ | Variant-based calculators |
| yard-documentation | skills/patterns/yard-documentation/ | Inline documentation with YARD |
Planning
| Skill | Path | Description |
|---|---|---|
| create-prd | skills/planning/create-prd/ | Generate PRD with goals, user stories |
| generate-tasks | skills/planning/generate-tasks/ | Convert PRD into TDD-ready tasks |
| ticket-planning | skills/planning/ticket-planning/ | Create tickets in issue tracker |
Testing
| Skill | Path | Description |
|---|---|---|
| rspec-best-practices | skills/testing/rspec-best-practices/ | TDD discipline, spec types |
| rspec-service-testing | skills/testing/rspec-service-testing/ | Service object specific testing |
| rails-tdd-slices | skills/testing/rails-tdd-slices/ | Choose the best first failing spec |
| rails-bug-triage | skills/testing/rails-bug-triage/ | Bug diagnosis and reproduction |
Workflows
| Skill | Path | Description |
|---|---|---|
| rails-tdd-loop | workflows/rails-tdd-loop/ | TDD feature loop: test → implement → review → PR |
| rails-review-flow | workflows/rails-review-flow/ | Systematic PR review: review → deep dive → response |
| rails-setup-flow | workflows/rails-setup-flow/ | Project setup: context → onboarding → CI/CD |
| rails-quality-flow | workflows/rails-quality-flow/ | Quality check: conventions → refactor → docs |
| rails-engines-flow | workflows/rails-engines-flow/ | Engine development: author → test → review → release |
build
docs
mcp_server
skills
api
api-rest-collection
rails-graphql-best-practices
code-quality
rails-architecture-review
rails-code-conventions
rails-code-review
rails-review-response
rails-security-review
rails-stack-conventions
assets
snippets
refactor-safely
context
rails-context-engineering
rails-project-onboarding
ddd
ddd-boundaries-review
ddd-rails-modeling
ddd-ubiquitous-language
engines
rails-engine-compatibility
rails-engine-docs
rails-engine-extraction
rails-engine-installers
rails-engine-release
rails-engine-reviewer
rails-engine-testing
infrastructure
rails-api-versioning
rails-background-jobs
rails-database-seeding
rails-frontend-hotwire
rails-migration-safety
rails-performance-optimization
orchestration
rails-skills-orchestrator
patterns
ruby-service-objects
strategy-factory-null-calculator
yard-documentation
planning
create-prd
generate-tasks
ticket-planning
testing
rails-bug-triage
rails-tdd-slices
rspec-best-practices
rspec-service-testing
workflows