CtrlK
BlogDocsLog inGet started
Tessl Logo

igmarin/rails-agent-skills

Curated library of 28 public AI agent skills for Ruby on Rails development. Organized by category: testing, code-quality, engines, infrastructure, api, and context. Covers code review, architecture, security, testing (RSpec), engines, Hotwire, and TDD automation. Shared Ruby skills (YARD docs, DDD, service objects) have moved to ruby-core-skills. Repository agents remain documented in GitHub but are intentionally excluded from the Tessl tile.

93

1.78x
Quality

95%

Does it follow best practices?

Impact

93%

1.78x

Average score across 28 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 Agent Loops

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]
    ↓
write-yard-docs *(from ruby-core-skills)*
    ↓
code-review → respond-to-review *(from ruby-core-skills)* (if feedback) → PR

Feature from Scratch

skills/context/load-context
    ↓
define-domain-language *(from ruby-core-skills)* → review-domain-boundaries *(from ruby-core-skills)* → model-domain *(from ruby-core-skills)*
    ↓
[TDD Feature Loop]

Bug Fix

triage-bug *(from ruby-core-skills)*
    ↓
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 *(from ruby-core-skills)*
    ↓
implement-graphql
    ↓
plan-tests
    ↓
[TDD Feature Loop]
    ↓
review-migration (if DB changes)
    ↓
security-check

External API Integration

plan-tests
    ↓
integrate-api-client *(from ruby-core-skills)*
    ↓
write-yard-docs *(from ruby-core-skills)*
    ↓
code-review

Integrations by Skill

plan-tests

NextWhen
write-testsTo write the spec

write-tests

NextWhen
create-service-object (from ruby-core-skills)If feature requires service
integrate-api-client (from ruby-core-skills)If integrating external API
implement-background-jobIf there are jobs
review-migrationIf there is a migration
implement-graphqlIf it's GraphQL

create-service-object (from ruby-core-skills)

NextWhen
test-serviceTo test the service
write-yard-docs (from ruby-core-skills)Document the public service

code-review

NextWhen
security-checkIf there are security concerns
review-architectureIf there are architecture issues
respond-to-review (from ruby-core-skills)If feedback received

Quick Decision Matrix

New to project?
  ├─ Yes → load-context → setup-environment
  └─ No → What do you need?

       Refactor?
            ├─ Yes → refactor-code
            └─ No → plan-tests → write-tests

                      Type?
                      ├─ Service → create-service-object *(from ruby-core-skills)* → test-service
                      ├─ API integration → integrate-api-client *(from ruby-core-skills)*
                      ├─ 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 *(from ruby-core-skills)*

Checkpoints and Gates

NameTypeDefined inPurpose
Test Feedbackcheckpointplan-testsConfirm correct test before implementing
Implementation Proposalcheckpointwrite-testsApprove approach before code
Linters + Suitegateagent-guide.mdAll linters and tests pass
Characterization Testsgaterefactor-codeTests pass on current code before refactor
Engine Specsgatecreate-engineSpecs fail before implementing engine

See also

  • Skill Catalog — Complete skills list
  • Agent Guides Index — Step-by-step agent stages

docs

reference

integration-matrix.md

skill-catalog.md

agent-guide.md

architecture.md

eval-provenance.md

index.md

README.md

skill-design-principles.md

skill-optimization-guide.md

skill-structure.md

skill-template.md

README.md

tile.json