igmarin/rails-agent-skills

Curated library of 42 public AI agent skills for Ruby on Rails development, plus 5 callable workflow skills. Organized by category: planning, testing, code-quality, ddd, engines, infrastructure, api, patterns, context, orchestration, and workflows. Covers code review, architecture, security, testing (RSpec), engines, service objects, DDD patterns, and TDD automation.

Quality

96%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Risky

Do not use without reviewing

Rails Agent Skills — Documentation

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

AI-Driven Rails Engineering: We turn coding assistants into reliable engineers through structured workflows, action-oriented skills, and a non-negotiable TDD quality gate.

This documentation defines the "operating system" for your development.

🚀 Quick Start decision map

Pick your current stage and follow the expert workflow.

If you are...	Use this...
New to the project	`load-context` → Discovery Guide
Ready to build a feature	TDD Workflow
Reviewing code	Review Workflow
Not sure where to start	`skill-router` (The entry point)

Architecture: Skills vs. Workflows

To save your token budget and keep the agent focused, we use a hybrid architecture:

Workflows (Resources): These are high-level guides (like the ones in workflows/) that the agent sees as "Resources". They tell the agent how to chain steps together.
Skills (Tools): These are atomic, expert instructions (like code-review or refactor-code). The agent loads them on-demand using the use_skill(name:) tool.

Master Workflow Index

Stage	Guide	Description	Primary Skills
Discovery	Discovery & Context	Understand codebase & onboarding	`load-context`, `setup-environment`
Planning	Planning & Design	PRDs, tasks, and DDD	`create-prd`, `generate-tasks`, `define-domain-language`
Setup	Setup & Configuration	CI/CD & infrastructure	`setup-environment`, `setup-ci-cd`
Development	Development	TDD & Implementation	`plan-tests`, `write-tests`, `triage-bug`
Quality	Code Quality	Conventions & refactoring	`apply-code-conventions`, `refactor-code`, `write-yard-docs`
Review	Review & Validation	Review, security, & architecture	`code-review`, `security-check`, `review-architecture`
Engines	Engine Development	Building Rails engines	`create-engine`, `release-engine`

Core Principles

🧪 Tests Gate Implementation

We never write implementation code until a test exists, runs, and fails. No exceptions.

🔗 Workflow Chaining

Skills are building blocks; workflows are the story. Follow the skill-router to find the right chain.

Reference & Authoring

Skill Catalog — Complete list of 39 skills with triggers.
Integration Matrix — How skills connect.
Skill Template — For creating new skills.
Implementation Guide — IDE Setup (MCP Server).

build

mcp_server

skills

workflows

README.md

tile.json