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.

1.77x

Quality

93%

Does it follow best practices?

Impact

96%

1.77x

Average score across 41 eval scenarios

Securityby

Passed

No known issues

Rails Agent Skills Documentation

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

This documentation is the public map for the Rails Agent Skills library: 41 public Rails skills, 5 callable workflows, an MCP distribution, and the evaluation process used to keep the skills useful.

For the high-level project value proposition, start with the root README. For installation and runtime setup, use the MCP server README.

Quick Start Decision Map

If you are...	Use this
New to the project	`load-context` and Discovery & Context
Ready to build a feature	Development workflow
Reviewing code	Review workflow
Not sure where to start	`skill-router`
Installing the library	Implementation guide
Validating skill quality	Eval provenance and Skill optimization

Architecture: Skills vs. Workflows

The repository uses a hybrid model to keep agent context focused:

Skills are atomic expert instructions such as code-review, plan-tests, or create-service-object. Agents load them on demand through the MCP use_skill tool or through an installed skill host.
Workflows are higher-level chains that combine multiple skills into a complete development loop, such as TDD feature work, code review, setup, quality checks, or engine development.

Master Workflow Index

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

Core Principles

Tests Gate Implementation

Implementation code waits until a test exists, has run, and fails for the expected reason. This is the central quality rule across code-producing skills.

Workflow Chaining

Skills are building blocks. Workflows define the sequence. Follow skill-router or the integration matrix when the next step is unclear.

Evaluation Ownership

Tessl validates publishable skills from tile.json using tessl-evals/. The upcoming ruby-skill-bench gem will use personal-evals/ for full-context skill and workflow validation. Root evals/ is generated Tessl staging output and should not be committed.

Reference & Authoring

Skill Catalog - Complete list of 41 public skills and 5 callable workflows.
Calling Skills Guide - Syntax and execution contexts (MCP, CLI, Chat).
Integration Matrix - How skills connect.
Workflow Guide - Narrative guide for daily use.
Implementation Guide - IDE and MCP setup overview.
Architecture - Repository layout and SKILL.md conventions.
Eval Provenance - Canonical eval ownership policy.
Skill Template - Template for creating new skills.

evals

mcp_server

skills

workflows

README.md

server.json

tile.json