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

setup.mddocs/workflows/

Workflow: Setup & Configuration (20)

Roadmap notice: the rails-ci-cd-setup skill referenced below is not yet implemented (see skill-catalog Roadmap). The templates on this page are kept as reference material so a maintainer can lift them when the skill ships. Until then, treat this workflow as informational, not as an active skill chain.

When to use: Configure CI/CD, deploy environment, or development infrastructure.


Main Flow: CI/CD Setup

graph TB
    subgraph Configure [⚙️ Phase 1: Configure]
        direction TB
        A[Need CI/CD] --> B[rails-ci-cd-setup]
        B --> C{GitHub or GitLab?}
        C --> D[Configure workflow]
    end

    subgraph Build [🔨 Phase 2: Build]
        direction TB
        D --> E[Parallel tests]
        E --> F[Security scanning]
        F --> G[Deploy strategy]
    end

    subgraph Verify [✅ Phase 3: Verify]
        direction TB
        G --> H{Working?}
        H -- No --> D
    end

    H -- Yes --> I((Start Development))

    %% Styling
    style Configure fill:#f5f5f5,stroke:#333,stroke-dasharray: 5 5
    style Build fill:#e1f5fe,stroke:#01579b
    style Verify fill:#fff3e0,stroke:#e65100
    style C fill:#ffd54f
    style H fill:#ffd54f
    style I fill:#e8f5e9,stroke:#1b5e20,stroke-width:3px

rails-ci-cd-setup (ROADMAP — not yet implemented)

Goal: Configure continuous integration pipeline for Rails.

CI/CD Checklist

  • Test workflowbundle exec rspec on each PR
  • Parallel tests — configure for speed
  • Lintersrubocop, erb-lint
  • Security scanningbrakeman, bundle-audit
  • Database setup — create + migrate in CI
  • Caching — gems, assets, node_modules
  • Deploy — staging/production with defined strategy

GitHub Actions Template

# .github/workflows/ci.yml
name: CI

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest

    services:
      postgres:
        image: postgres:15
        env:
          POSTGRES_PASSWORD: postgres
        options: >-
          --health-cmd pg_isready
          --health-interval 10s
          --health-timeout 5s
          --health-retries 5
        ports:
          - 5432:5432

    steps:
      - uses: actions/checkout@v4

      - name: Setup Ruby
        uses: ruby/setup-ruby@v1
        with:
          ruby-version: '3.2'
          bundler-cache: true

      - name: Setup Database
        env:
          RAILS_ENV: test
          DATABASE_URL: postgres://postgres:postgres@localhost:5432/test
        run: |
          bin/rails db:create db:migrate

      - name: Run Tests
        env:
          DATABASE_URL: postgres://postgres:postgres@localhost:5432/test
        run: bundle exec rspec

      - name: Run Linters
        run: |
          bundle exec rubocop
          bundle exec erb-lint app/views

Security Scanning

# Security job
security:
  runs-on: ubuntu-latest
  steps:
    - uses: actions/checkout@v4

    - name: Setup Ruby
      uses: ruby/setup-ruby@v1
      with:
        bundler-cache: true

    - name: Brakeman
      run: bundle exec brakeman -q -w2 --no-pager

    - name: Bundle Audit
      run: bundle exec bundle-audit check --update

Deployment Strategies

StrategyWhen to useComplexity
BasicSimple apps, low trafficLow
Blue-GreenZero-downtime requiredMedium
CanaryGradual rollout, high trafficHigh

Integration with Development

If setup is done...Next step
CI/CD readyrails-tdd-slicesdevelopment
Need new featurecreate-prdplanning

Skills in this Workflow

SkillDescriptionTrigger words
rails-ci-cd-setup (roadmap)Configure CI/CD pipeline"CI/CD", "GitHub Actions", "GitLab CI", "deploy"
rails-project-onboardingDev environment setup"onboarding", "setup project", "Docker"

docs

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