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.

1.78x

Quality

95%

Does it follow best practices?

Impact

93%

1.78x

Average score across 28 eval scenarios

Securityby

Passed

No known issues

Agent Stage: Discovery & Context (00)

Name: igmarin/rails-agent-skills
Rating: 93.21 (1 reviews)
Author: igmarin

When to use: New to a project, need to understand the codebase, or setting up development environment.

Main Flow: New Developer on Project

graph TB
    subgraph Context [🔍 Phase 1: Understand]
        direction TB
        A[New to project] --> B[load-context]
        B --> C{Understood?}
        C -- No --> B
    end

    subgraph Setup [⚙️ Phase 2: Setup]
        direction TB
        C -- Yes --> D[setup-environment]
        D --> E{Ready?}
        E -- No --> D
    end

    E -- Yes --> F((Start Development))

    %% Styling
    style Context fill:#f5f5f5,stroke:#333,stroke-dasharray: 5 5
    style Setup fill:#e1f5fe,stroke:#01579b
    style C fill:#ffd54f
    style E fill:#ffd54f
    style F fill:#e8f5e9,stroke:#1b5e20,stroke-width:3px

Step 1: load-context

Goal: Load the minimum context needed before writing code, tests, or PRDs.

What it does:

Inspects db/schema.rb — data structure
Reads config/routes.rb — HTTP surface
Finds neighboring models, controllers, services
Reads existing factories and specs
Detects ambiguities between requirements and code

Output: Context Summary posted before any code proposal.

When to invoke:

"Before I code on this, what's the existing pattern?"
"Where is this defined in the codebase?"
"Match existing style"

Step 2: setup-environment (NEW)

Goal: Complete development environment setup.

Onboarding Checklist

Repository cloned and structure understood
Docker / docker-compose configured (if applicable)
Environment variables set up (.env, credentials)
Database created, migrated, seeded
Test suite running locally
Linters installed and configured
IDE/Editor configured (Ruby LSP, plugins)
Git hooks installed (pre-commit, etc.)
Documentation read (README, ARCHITECTURE.md)

Standard Rails App Structure

app/
├── controllers/      # HTTP layer, thin
├── models/          # Domain logic + persistence
├── services/        # Business operations
├── jobs/            # Background processing
├── views/           # ERB/HAML + Hotwire
└── helpers/         # View utilities

config/
├── routes.rb        # Routing table
└── initializers/    # Gem configs

spec/ or test/
├── models/          # Unit tests
├── requests/        # Integration tests
├── services/        # Service tests
└── system/          # E2E tests

agents/              # Callable agents
├── tdd/             # TDD agent
└── ...

docs/
├── architecture.md  # System design
└── api/             # API documentation

Database Setup Commands

# Standard setup
bin/rails db:create
bin/rails db:migrate
bin/rails db:seed

# Test environment
RAILS_ENV=test bin/rails db:create db:migrate

# With Docker
docker-compose up -d db
docker-compose run web bin/rails db:create db:migrate db:seed

Environment Variables Checklist

Variable	Purpose	Where to define
`DATABASE_URL`	DB connection	`.env` / env vars
`REDIS_URL`	Cache/Sidekiq	`.env`
`RAILS_MASTER_KEY`	Encrypted credentials	env var only (never in repo)
`AWS_` / `S3_`	Storage	credentials.yml.enc
`SENDGRID_*`	Email	credentials.yml.enc
`STRIPE_*`	Payments	credentials.yml.enc

Integration with Next Steps

If you need...	Next skill
To start coding	`plan-tests` → development
To fix a bug	`triage-bug` → development#bug-fix
To configure CI/CD	(roadmap — `setup-ci-cd`, see setup)

Hard Gate: No Code Without Context

DO NOT write implementation code before running load-context.
ALWAYS post the Context Summary and resolve any ambiguities first.

Skills in this Stage

Skill	Description	Trigger words
load-context	Load context before coding	"load context", "before I code", "match existing style"
setup-environment	Dev environment setup	"onboarding", "new dev", "setup project", "Docker"