CtrlK
BlogDocsLog inGet started
Tessl Logo

igmarin/rails-agent-skills

Curated library of 41 public AI agent skills for Ruby on Rails development. Organized by category: planning, testing, code-quality, ddd, engines, infrastructure, api, patterns, context, and orchestration. Covers code review, architecture, security, testing (RSpec), engines, service objects, DDD patterns, and TDD automation. Repository workflows remain documented in GitHub but are intentionally excluded from the Tessl tile.

95

1.77x
Quality

93%

Does it follow best practices?

Impact

96%

1.77x

Average score across 41 eval scenarios

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

setup.mddocs/workflows/

Workflow: Setup & Configuration (20)

Roadmap notice: the setup-ci-cd 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[setup-ci-cd]
        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

setup-ci-cd (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@34e114876b0b11c390a56381ad16ebd13914f8d5

      - name: Setup Ruby
        uses: ruby/setup-ruby@ff740bc00a01b3a50fffc55a1071b1060eeae9dc
        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@34e114876b0b11c390a56381ad16ebd13914f8d5

    - name: Setup Ruby
      uses: ruby/setup-ruby@ff740bc00a01b3a50fffc55a1071b1060eeae9dc
      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 readyplan-testsdevelopment
Need new featurecreate-prdplanning

Skills in this Workflow

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

docs

architecture.md

calling-skills.md

eval-provenance.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

server.json

tile.json