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

integration-matrix.mddocs/reference/

Integration Matrix — Rails Agent Skills

Integration matrix: which skill connects to which and in what order.

Format

  • A → B means: after A, B typically follows
  • [checkpoint] indicates explicit pause point
  • [gate] indicates mandatory gate

Complete Workflows

TDD Feature Loop (Main)

skills/context/rails-context-engineering
    ↓
skills/testing/rails-tdd-slices
    ↓
skills/testing/rspec-best-practices → [checkpoint: Test Feedback]
    ↓
[checkpoint: Implementation Proposal]
    ↓
Implement
    ↓
[gate: Linters + Full Suite]
    ↓
skills/patterns/yard-documentation
    ↓
rails-code-review → skills/code-quality/rails-review-response (if feedback) → PR

Feature from Scratch

skills/context/rails-context-engineering
    ↓
create-prd → [gate: PRD approved]
    ↓
generate-tasks
    ↓
[TDD Feature Loop for each task]

Feature DDD-First

skills/context/rails-context-engineering
    ↓
create-prd
    ↓
skills/ddd/ddd-ubiquitous-language → skills/ddd/ddd-boundaries-review → skills/ddd/ddd-rails-modeling
    ↓
generate-tasks
    ↓
[TDD Feature Loop]

Bug Fix

rails-bug-triage
    ↓
rails-tdd-slices
    ↓
[gate: Write failing reproduction spec]
    ↓
Minimal fix
    ↓
Verify passes + no regressions
    ↓
rails-code-review

Refactoring

refactor-safely
    ↓
[gate: Characterization tests pass]
    ↓
Extract in small steps
    ↓
Verify after each step
    ↓
rails-code-review

New Engine

rails-engine-author
    ↓
[gate: Engine specs fail]
    ↓
rails-engine-testing
    ↓
rails-engine-docs
    ↓
rails-engine-installers
    ↓
rails-engine-reviewer
    ↓
rails-engine-release
    ↓
rails-engine-compatibility

Engine Extraction

rails-engine-extraction
    ↓
refactor-safely
    ↓
[gate: Characterization tests]
    ↓
rails-engine-author
    ↓
rails-engine-testing

GraphQL Feature

ddd-ubiquitous-language
    ↓
rails-graphql-best-practices
    ↓
rails-tdd-slices
    ↓
[TDD Feature Loop]
    ↓
rails-migration-safety (if DB changes)
    ↓
rails-security-review

External API Integration

create-prd
    ↓
generate-tasks
    ↓
rails-tdd-slices
    ↓
ruby-api-client-integration
    ↓
yard-documentation
    ↓
rails-code-review

Integrations by Skill

create-prd

NextWhen
generate-tasksAlways after PRD approved
ticket-planningOptional — if tickets needed in tracker

generate-tasks

NextWhen
rails-tdd-slicesTo start development
ticket-planningIf tickets needed on board

rails-tdd-slices

NextWhen
rspec-best-practicesTo write the spec

rspec-best-practices

NextWhen
ruby-service-objectsIf feature requires service
ruby-api-client-integrationIf integrating external API
rails-background-jobsIf there are jobs
rails-migration-safetyIf there is a migration
rails-graphql-best-practicesIf it's GraphQL

ruby-service-objects

NextWhen
rspec-service-testingTo test the service
yard-documentationDocument the public service

rails-code-review

NextWhen
rails-security-reviewIf there are security concerns
rails-architecture-reviewIf there are architecture issues
rails-review-responseIf feedback received

Quick Decision Matrix

New to project?
  ├─ Yes → rails-context-engineering → rails-project-onboarding
  └─ No → What do you need?

       Plan?
       ├─ Yes → create-prd → generate-tasks
       └─ No → Implement?

            Bug?
            ├─ Yes → rails-bug-triage
            └─ No → Refactor?
                 ├─ Yes → refactor-safely
                 └─ No → rails-tdd-slices → rspec-best-practices

                      Type?
                      ├─ Service → ruby-service-objects → rspec-service-testing
                      ├─ API integration → ruby-api-client-integration
                      ├─ Background job → rails-background-jobs
                      ├─ Migration → rails-migration-safety
                      ├─ GraphQL → rails-graphql-best-practices
                      ├─ Authorization → rails-authorization-policies
                      ├─ Performance → rails-performance-optimization
                      └─ Engine → rails-engine-author

Review?
  └─ rails-code-review → (rails-security-review | rails-architecture-review) → rails-review-response

Checkpoints and Gates

NameTypeDefined inPurpose
Test Feedbackcheckpointrails-tdd-slicesConfirm correct test before implementing
Implementation Proposalcheckpointrspec-best-practicesApprove approach before code
Linters + Suitegateworkflow-guide.mdAll linters and tests pass
PRD Approvedgatecreate-prdDon't implement without approved PRD
Characterization Testsgaterefactor-safelyTests pass on current code before refactor
Engine Specsgaterails-engine-authorSpecs fail before implementing engine

See also

  • Skill Catalog — Complete skills list
  • Workflows Index — Step-by-step workflows

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