igmarin/rails-agent-skills
Curated library of 41 public AI agent skills for Ruby on Rails development. Organized by category: planning, testing, code-quality, ddd, engines, infrastructure, api, patterns, context, and orchestration. Covers code review, architecture, security, testing (RSpec), engines, service objects, DDD patterns, and TDD automation. Repository workflows remain documented in GitHub but are intentionally excluded from the Tessl tile.
95
93%
Does it follow best practices?
Impact
96%
1.77xAverage score across 41 eval scenarios
Passed
No known issues
integration-matrix.mddocs/reference/
Integration Matrix — Rails Agent Skills
Integration matrix: which skill connects to which and in what order.
Format
A → Bmeans: after A, B typically follows[checkpoint]indicates explicit pause point[gate]indicates mandatory gate
Complete Workflows
TDD Feature Loop (Main)
skills/context/load-context
↓
skills/testing/plan-tests
↓
skills/testing/write-tests → [checkpoint: Test Feedback]
↓
[checkpoint: Implementation Proposal]
↓
Implement
↓
[gate: Linters + Full Suite]
↓
skills/patterns/write-yard-docs
↓
code-review → skills/code-quality/respond-to-review (if feedback) → PRFeature from Scratch
skills/context/load-context
↓
create-prd → [gate: PRD approved]
↓
generate-tasks
↓
[TDD Feature Loop for each task]Feature DDD-First
skills/context/load-context
↓
create-prd
↓
skills/ddd/define-domain-language → skills/ddd/review-domain-boundaries → skills/ddd/model-domain
↓
generate-tasks
↓
[TDD Feature Loop]Bug Fix
triage-bug
↓
plan-tests
↓
[gate: Write failing reproduction spec]
↓
Minimal fix
↓
Verify passes + no regressions
↓
code-reviewRefactoring
refactor-code
↓
[gate: Characterization tests pass]
↓
Extract in small steps
↓
Verify after each step
↓
code-reviewNew Engine
create-engine
↓
[gate: Engine specs fail]
↓
test-engine
↓
document-engine
↓
create-engine-installer
↓
review-engine
↓
release-engine
↓
upgrade-engineEngine Extraction
extract-engine
↓
refactor-code
↓
[gate: Characterization tests]
↓
create-engine
↓
test-engineGraphQL Feature
define-domain-language
↓
implement-graphql
↓
plan-tests
↓
[TDD Feature Loop]
↓
review-migration (if DB changes)
↓
security-checkExternal API Integration
create-prd
↓
generate-tasks
↓
plan-tests
↓
integrate-api-client
↓
write-yard-docs
↓
code-reviewIntegrations by Skill
create-prd
| Next | When |
|---|---|
| generate-tasks | Always after PRD approved |
| plan-tickets | Optional — if tickets needed in tracker |
generate-tasks
| Next | When |
|---|---|
| plan-tests | To start development |
| plan-tickets | If tickets needed on board |
plan-tests
| Next | When |
|---|---|
| write-tests | To write the spec |
write-tests
| Next | When |
|---|---|
| create-service-object | If feature requires service |
| integrate-api-client | If integrating external API |
| implement-background-job | If there are jobs |
| review-migration | If there is a migration |
| implement-graphql | If it's GraphQL |
create-service-object
| Next | When |
|---|---|
| test-service | To test the service |
| write-yard-docs | Document the public service |
code-review
| Next | When |
|---|---|
| security-check | If there are security concerns |
| review-architecture | If there are architecture issues |
| respond-to-review | If feedback received |
Quick Decision Matrix
New to project?
├─ Yes → load-context → setup-environment
└─ No → What do you need?
Plan?
├─ Yes → create-prd → generate-tasks
└─ No → Implement?
Bug?
├─ Yes → triage-bug
└─ No → Refactor?
├─ Yes → refactor-code
└─ No → plan-tests → write-tests
Type?
├─ Service → create-service-object → test-service
├─ API integration → integrate-api-client
├─ Background job → implement-background-job
├─ Migration → review-migration
├─ GraphQL → implement-graphql
├─ Authorization → implement-authorization
├─ Performance → optimize-performance
└─ Engine → create-engine
Review?
└─ code-review → (security-check | review-architecture) → respond-to-reviewCheckpoints and Gates
| Name | Type | Defined in | Purpose |
|---|---|---|---|
| Test Feedback | checkpoint | plan-tests | Confirm correct test before implementing |
| Implementation Proposal | checkpoint | write-tests | Approve approach before code |
| Linters + Suite | gate | workflow-guide.md | All linters and tests pass |
| PRD Approved | gate | create-prd | Don't implement without approved PRD |
| Characterization Tests | gate | refactor-code | Tests pass on current code before refactor |
| Engine Specs | gate | create-engine | Specs fail before implementing engine |
See also
- Skill Catalog — Complete skills list
- Workflows Index — Step-by-step workflows
docs
evals
scenario-1
scenario-2
scenario-3
scenario-4
scenario-5
scenario-6
scenario-7
scenario-8
scenario-9
scenario-10
scenario-11
scenario-12
scenario-13
scenario-14
scenario-15
scenario-16
scenario-17
scenario-18
scenario-19
scenario-20
scenario-21
scenario-22
scenario-23
scenario-24
scenario-25
scenario-26
scenario-27
scenario-28
scenario-29
scenario-30
scenario-31
scenario-32
scenario-33
scenario-34
scenario-35
scenario-36
scenario-37
scenario-38
scenario-39
scenario-40
scenario-41
mcp_server
skills
api
generate-api-collection
implement-graphql
code-quality
apply-code-conventions
apply-stack-conventions
assets
snippets
code-review
refactor-code
respond-to-review
review-architecture
security-check
context
load-context
setup-environment
ddd
define-domain-language
model-domain
review-domain-boundaries
engines
create-engine
create-engine-installer
document-engine
extract-engine
release-engine
review-engine
test-engine
upgrade-engine
infrastructure
implement-background-job
implement-hotwire
optimize-performance
review-migration
seed-database
version-api
orchestration
skill-router
patterns
create-service-object
implement-calculator-pattern
write-yard-docs
planning
create-prd
generate-tasks
plan-tickets
testing
plan-tests
test-service
triage-bug
write-tests
workflows