CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

96

Quality

96%

Does it follow best practices?

Impact

—

No eval scenarios have been run

SecuritybySnyk

Risky

Do not use without reviewing

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/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) → PR

Feature 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-review

Refactoring

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

New Engine

create-engine
    ↓
[gate: Engine specs fail]
    ↓
test-engine
    ↓
document-engine
    ↓
create-engine-installer
    ↓
review-engine
    ↓
release-engine
    ↓
upgrade-engine

Engine Extraction

extract-engine
    ↓
refactor-code
    ↓
[gate: Characterization tests]
    ↓
create-engine
    ↓
test-engine

GraphQL Feature

define-domain-language
    ↓
implement-graphql
    ↓
plan-tests
    ↓
[TDD Feature Loop]
    ↓
review-migration (if DB changes)
    ↓
security-check

External API Integration

create-prd
    ↓
generate-tasks
    ↓
plan-tests
    ↓
integrate-api-client
    ↓
write-yard-docs
    ↓
code-review

Integrations by Skill

create-prd

NextWhen
generate-tasksAlways after PRD approved
plan-ticketsOptional — if tickets needed in tracker

generate-tasks

NextWhen
plan-testsTo start development
plan-ticketsIf tickets needed on board

plan-tests

NextWhen
write-testsTo write the spec

write-tests

NextWhen
create-service-objectIf feature requires service
integrate-api-clientIf integrating external API
implement-background-jobIf there are jobs
review-migrationIf there is a migration
implement-graphqlIf it's GraphQL

create-service-object

NextWhen
test-serviceTo test the service
write-yard-docsDocument the public service

code-review

NextWhen
security-checkIf there are security concerns
review-architectureIf there are architecture issues
respond-to-reviewIf 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-review

Checkpoints and Gates

NameTypeDefined inPurpose
Test Feedbackcheckpointplan-testsConfirm correct test before implementing
Implementation Proposalcheckpointwrite-testsApprove approach before code
Linters + Suitegateworkflow-guide.mdAll linters and tests pass
PRD Approvedgatecreate-prdDon't implement without approved PRD
Characterization Testsgaterefactor-codeTests pass on current code before refactor
Engine Specsgatecreate-engineSpecs 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