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

EXAMPLES.mdskills/code-quality/refactor-safely/

Refactor Safely Examples

Use these examples when the main SKILL.md flow is clear and you need concrete execution patterns.

Example 1: Extract Service from Controller

Stable behavior to preserve:
"Creating an order validates line items, applies pricing, persists the order, and enqueues NotifyWarehouseJob."

Smallest safe sequence:

  1. Add a characterization test (request or service spec) that covers current OrdersController#create.
  2. Extract Orders::CreateOrder with identical behavior and call it from the controller.
  3. Keep response/redirect logic unchanged while migrating internals.
  4. Remove duplication from controller once the new path is proven.
  5. Run full tests after each step.

Example 2: Rename in Small Batches

Goal: Rename Order to Purchase safely.

Safe sequence:

  1. Introduce compatibility alias/wrapper (temporary).
  2. Rename a small set of call sites (one boundary at a time).
  3. Run full suite after each batch.
  4. Remove alias only when all call sites are migrated and tests are green.

Anti-Pattern Example

Avoid: "Rename Order to Purchase and update all 50 call sites in one PR."

Why unsafe: Too many touchpoints in one step, high rollback cost, poor reviewability, and no isolation when tests fail.

skills

code-quality

README.md

tile.json