CtrlK
BlogDocsLog inGet started
Tessl Logo

igmarin/rails-agent-skills

Curated library of 39 AI agent skills for Ruby on Rails development. Organized by category: planning, testing, code-quality, ddd, engines, infrastructure, api, patterns, context, orchestration, and workflows. Includes 5 callable workflow skills (rails-tdd-loop, rails-review-flow, rails-setup-flow, rails-quality-flow, rails-engines-flow) for complete development cycles. Covers code review, architecture, security, testing (RSpec), engines, service objects, DDD patterns, and TDD automation.

95

1.20x
Quality

98%

Does it follow best practices?

Impact

95%

1.20x

Average score across 35 eval scenarios

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

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

SkillDescriptionTrigger Words
rails-context-engineeringLoad 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

SkillDescriptionTrigger Words
create-prdGenerate PRD with goals, user stories, requirements"plan feature", "create PRD", "requirements", "feature spec"
generate-tasksConvert PRD into TDD-ready tasks with exact paths"break into tasks", "implementation plan", "task list", "generate tasks"
ticket-planningCreate tickets in issue tracker from plan"create tickets", "Jira", "Linear", "GitHub Issues"
ddd-ubiquitous-languageDomain terms glossary"domain terms", "ubiquitous language", "what should we call this", "naming"
ddd-boundaries-reviewReview bounded contexts and language leakage"context boundaries", "language leakage", "ownership", "cross-context"
ddd-rails-modelingMap 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

SkillDescriptionTrigger Words
rails-tdd-slicesChoose the best first failing spec"where to start testing", "what test first", "TDD", "first failing spec"
rspec-best-practicesTDD discipline, spec types, factory design"write test", "RSpec", "test-driven", "spec type"
rspec-service-testingService 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-integrationLayered architecture for external APIs"API integration", "HTTP client", "external API", "third party"
rails-background-jobsActive Job, Solid Queue, Sidekiq, idempotency"background job", "Active Job", "async", "Sidekiq", "worker"
rails-migration-safetySafe migrations for production"migration", "add column", "index", "backfill", "zero-downtime"
rails-graphql-best-practicesSchema design, N+1 prevention, auth"GraphQL", "resolver", "mutation", "dataloader"
rails-bug-triageBug 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-calculatorVariant-based calculators"calculator", "strategy pattern", "factory", "dispatch", "variant"

40 — Code Quality

SkillDescriptionTrigger Words
refactor-safelyRefactor preserving behavior"refactor", "extract", "restructure", "clean up"
rails-code-conventionsDRY/YAGNI/PORO/CoC/KISS by path"code review", "conventions", "clean code", "DRY", "YAGNI"
yard-documentationInline documentation with YARD"YARD", "documentation", "@param", "@return", "inline docs"
rails-stack-conventionsStack-specific conventions (PostgreSQL, Hotwire, Tailwind)"stack", "PostgreSQL", "Hotwire", "Tailwind", "conventions"

50 — Review & Validation

SkillDescriptionTrigger Words
rails-code-reviewSystematic Rails PR review"review PR", "code review", "check this code", "CR"
rails-review-responseRespond to review feedback"feedback", "review comments", "address feedback", "respond"
rails-security-reviewDeep security audit"security", "audit", "vulnerability", "XSS", "SQL injection", "CSRF"
rails-architecture-reviewStructural boundary review"architecture", "structure", "boundaries", "fat model", "extract"
api-rest-collectionGenerate Postman collections for APIs"Postman", "API collection", "REST", "test endpoints"

60 — Engines

SkillDescriptionTrigger Words
rails-engine-authorRails engine scaffolding"create engine", "new engine", "mountable engine"
rails-engine-testingEngine testing setup"test engine", "dummy app", "engine specs"
rails-engine-docsEngine documentation"engine README", "install guide", "engine docs"
rails-engine-installersInstall generators"install generator", "engine setup", "copy migrations"
rails-engine-reviewerComplete engine review"review engine", "engine quality", "engine audit"
rails-engine-releaseVersioned engine release"release engine", "version bump", "publish gem", "changelog"
rails-engine-compatibilityCross-version compatibility"Zeitwerk", "compatibility", "Rails upgrade", "cross-version"
rails-engine-extractionExtract code to engine"extract to engine", "move feature", "host coupling"

Skills by Objective (Quick Lookup)

If you need...

You need...Recommended Skill(s)
Understand codebaserails-context-engineering
New project setuprails-project-onboarding
Plan featurecreate-prd → generate-tasks
Start codingrails-tdd-slices → rspec-best-practices
Fix bugrails-bug-triage
Refactorrefactor-safely
Create serviceruby-service-objects
Integrate external APIruby-api-client-integration
Add auth/rolesrails-authorization-policies
Optimize performancerails-performance-optimization
Create enginerails-engine-author
Review coderails-code-review
Respond to feedbackrails-review-response
Setup CI/CD(roadmap — rails-ci-cd-setup)
Not surerails-skills-orchestrator

Proposed New Skills (Roadmap)

SkillPriorityStatus
rails-ci-cd-setup🔴 CriticalNot 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

SkillPathDescription
api-rest-collectionskills/api/api-rest-collection/Generate Postman collections for REST APIs
rails-graphql-best-practicesskills/api/rails-graphql-best-practices/Schema design, N+1 prevention, auth
ruby-api-client-integrationskills/api/ruby-api-client-integration/Layered architecture for external APIs

Context

SkillPathDescription
rails-context-engineeringskills/context/rails-context-engineering/Load minimum context before coding
rails-project-onboardingskills/context/rails-project-onboarding/Complete dev environment setup

Code Quality

SkillPathDescription
rails-code-reviewskills/code-quality/rails-code-review/Systematic Rails PR review
rails-review-responseskills/code-quality/rails-review-response/Respond to review feedback
rails-architecture-reviewskills/code-quality/rails-architecture-review/Structural boundary review
rails-security-reviewskills/code-quality/rails-security-review/Deep security audit
rails-stack-conventionsskills/code-quality/rails-stack-conventions/Stack-specific conventions
rails-code-conventionsskills/code-quality/rails-code-conventions/DRY/YAGNI/PORO/CoC/KISS by path
rails-authorization-policiesskills/code-quality/rails-authorization-policies/Pundit/CanCanCan, roles, permissions
refactor-safelyskills/code-quality/refactor-safely/Refactor preserving behavior

DDD

SkillPathDescription
ddd-ubiquitous-languageskills/ddd/ddd-ubiquitous-language/Domain terms glossary
ddd-boundaries-reviewskills/ddd/ddd-boundaries-review/Review bounded contexts
ddd-rails-modelingskills/ddd/ddd-rails-modeling/Map DDD to Rails

Engines

SkillPathDescription
rails-engine-authorskills/engines/rails-engine-author/Rails engine scaffolding
rails-engine-testingskills/engines/rails-engine-testing/Engine testing setup
rails-engine-reviewerskills/engines/rails-engine-reviewer/Complete engine review
rails-engine-releaseskills/engines/rails-engine-release/Versioned engine release
rails-engine-docsskills/engines/rails-engine-docs/Engine documentation
rails-engine-installersskills/engines/rails-engine-installers/Install generators
rails-engine-extractionskills/engines/rails-engine-extraction/Extract code to engine
rails-engine-compatibilityskills/engines/rails-engine-compatibility/Cross-version compatibility

Infrastructure

SkillPathDescription
rails-migration-safetyskills/infrastructure/rails-migration-safety/Safe migrations for production
rails-background-jobsskills/infrastructure/rails-background-jobs/Active Job, Solid Queue, Sidekiq
rails-database-seedingskills/infrastructure/rails-database-seeding/Fixtures vs Seeds
rails-performance-optimizationskills/infrastructure/rails-performance-optimization/N+1s, profiling, caching
rails-api-versioningskills/infrastructure/rails-api-versioning/REST API versioning
rails-frontend-hotwireskills/infrastructure/rails-frontend-hotwire/Turbo/Stimulus integration

Orchestration

SkillPathDescription
rails-skills-orchestratorskills/orchestration/rails-skills-orchestrator/Routes to correct specialized skill

Patterns

SkillPathDescription
ruby-service-objectsskills/patterns/ruby-service-objects/.call pattern, response contract
strategy-factory-null-calculatorskills/patterns/strategy-factory-null-calculator/Variant-based calculators
yard-documentationskills/patterns/yard-documentation/Inline documentation with YARD

Planning

SkillPathDescription
create-prdskills/planning/create-prd/Generate PRD with goals, user stories
generate-tasksskills/planning/generate-tasks/Convert PRD into TDD-ready tasks
ticket-planningskills/planning/ticket-planning/Create tickets in issue tracker

Testing

SkillPathDescription
rspec-best-practicesskills/testing/rspec-best-practices/TDD discipline, spec types
rspec-service-testingskills/testing/rspec-service-testing/Service object specific testing
rails-tdd-slicesskills/testing/rails-tdd-slices/Choose the best first failing spec
rails-bug-triageskills/testing/rails-bug-triage/Bug diagnosis and reproduction

Workflows

SkillPathDescription
rails-tdd-loopskills/workflows/rails-tdd-loop/TDD feature loop: test → implement → review → PR
rails-review-flowskills/workflows/rails-review-flow/Systematic PR review: review → deep dive → response
rails-setup-flowskills/workflows/rails-setup-flow/Project setup: context → onboarding → CI/CD
rails-quality-flowskills/workflows/rails-quality-flow/Quality check: conventions → refactor → docs
rails-engines-flowskills/workflows/rails-engines-flow/Engine development: author → test → review → release

docs

reference

integration-matrix.md

skill-catalog.md

architecture.md

implementation-guide.md

index.md

plugin-validation.md

README.md

skill-design-principles.md

skill-optimization-guide.md

skill-structure.md

skill-template.md

vs-code-setup.md

workflow-guide.md

README.md

tile.json