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

Skill Catalog — Rails Agent Skills

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

Complete catalog of 41 public skills and 5 callable workflows organized by development lifecycle stage and by category.

Quick Navigation

By Stage: 00 — Discovery · 10 — Planning · 30 — Development · 40 — Quality · 50 — Review · 60 — Engines

By Category: API · Context · Code Quality · DDD · Engines · Infrastructure · Orchestration · Patterns · Planning · Testing · Workflows

00 — Discovery & Context

Skill	Description	Trigger Words
load-context	Load minimum context before coding (schema, routes, neighbors)	"load context", "before I code", "match existing style", "what does this codebase use"
setup-environment (NEW)	Complete dev environment setup (Docker, env vars, db)	"onboarding", "new dev", "setup project", "Docker", "environment"

10 — Planning & Design

Skill	Description	Trigger Words
create-prd	Generate PRD with goals, user stories, requirements	"plan feature", "create PRD", "requirements", "feature spec"
generate-tasks	Convert PRD into TDD-ready tasks with exact paths	"break into tasks", "implementation plan", "task list", "generate tasks"
plan-tickets	Create tickets in issue tracker from plan	"create tickets", "Jira", "Linear", "GitHub Issues"
define-domain-language	Domain terms glossary	"domain terms", "ubiquitous language", "what should we call this", "naming"
review-domain-boundaries	Review bounded contexts and language leakage	"context boundaries", "language leakage", "ownership", "cross-context"
model-domain	Map DDD to Rails (models, services, VO)	"aggregate", "value object", "domain event", "repository", "DDD"

20 — Setup & Configuration

No shipped skills in this stage yet. See Roadmap for setup-ci-cd.

30 — Development

Skill	Description	Trigger Words
plan-tests	Choose the best first failing spec	"where to start testing", "what test first", "TDD", "first failing spec"
write-tests	TDD discipline, spec types, factory design	"write test", "RSpec", "test-driven", "spec type"
test-service	Service object specific testing	"test service", "spec/services", "service spec"
create-service-object	`.call` pattern, response contract, YARD	"create service", "extract service", ".call", "service object"
integrate-api-client	Layered architecture for external APIs	"API integration", "HTTP client", "external API", "third party"
implement-background-job	Active Job, Solid Queue, Sidekiq, idempotency	"background job", "Active Job", "async", "Sidekiq", "worker"
review-migration	Safe migrations for production	"migration", "add column", "index", "backfill", "zero-downtime"
implement-graphql	Schema design, N+1 prevention, auth	"GraphQL", "resolver", "mutation", "dataloader"
triage-bug	Bug diagnosis and reproduction	"bug", "debug", "fix", "broken", "error", "regression"
implement-authorization (NEW)	Pundit/CanCanCan, roles, permissions	"authorization", "Pundit", "CanCanCan", "roles", "permissions", "policy"
optimize-performance (NEW)	N+1s, profiling, caching, query optimization	"N+1", "slow", "performance", "optimize", "caching", "profiling"
version-api (NEW)	REST API versioning	"API version", "v1", "v2", "versioning", "deprecation"
seed-database (NEW)	Fixtures vs Seeds for dev/test	"seeds", "fixtures", "test data", "development data"
implement-hotwire (NEW)	Turbo/Stimulus integration	"Hotwire", "Turbo", "Stimulus", "SPA", "frames", "streams"
implement-calculator-pattern	Variant-based calculators	"calculator", "strategy pattern", "factory", "dispatch", "variant"

40 — Code Quality

Skill	Description	Trigger Words
refactor-code	Refactor preserving behavior	"refactor", "extract", "restructure", "clean up"
apply-code-conventions	DRY/YAGNI/PORO/CoC/KISS by path	"code review", "conventions", "clean code", "DRY", "YAGNI"
write-yard-docs	Inline documentation with YARD	"YARD", "documentation", "@param", "@return", "inline docs"
apply-stack-conventions	Stack-specific conventions (PostgreSQL, Hotwire, Tailwind)	"stack", "PostgreSQL", "Hotwire", "Tailwind", "conventions"

50 — Review & Validation

Skill	Description	Trigger Words
code-review	Systematic Rails PR review	"review PR", "code review", "check this code", "CR"
respond-to-review	Respond to review feedback	"feedback", "review comments", "address feedback", "respond"
security-check	Deep security audit	"security", "audit", "vulnerability", "XSS", "SQL injection", "CSRF"
review-architecture	Structural boundary review	"architecture", "structure", "boundaries", "fat model", "extract"
generate-api-collection	Generate Postman collections for APIs	"Postman", "API collection", "REST", "test endpoints"

60 — Engines

Skill	Description	Trigger Words
create-engine	Rails engine scaffolding	"create engine", "new engine", "mountable engine"
test-engine	Engine testing setup	"test engine", "dummy app", "engine specs"
document-engine	Engine documentation	"engine README", "install guide", "engine docs"
create-engine-installer	Install generators	"install generator", "engine setup", "copy migrations"
review-engine	Complete engine review	"review engine", "engine quality", "engine audit"
release-engine	Versioned engine release	"release engine", "version bump", "publish gem", "changelog"
upgrade-engine	Cross-version compatibility	"Zeitwerk", "compatibility", "Rails upgrade", "cross-version"
extract-engine	Extract code to engine	"extract to engine", "move feature", "host coupling"

Skills by Objective (Quick Lookup)

If you need...

You need...	Recommended Skill(s)
Understand codebase	`load-context`
New project setup	`setup-environment`
Plan feature	`create-prd` → `generate-tasks`
Start coding	`plan-tests` → `write-tests`
Fix bug	`triage-bug`
Refactor	`refactor-code`
Create service	`create-service-object`
Integrate external API	`integrate-api-client`
Add auth/roles	`implement-authorization`
Optimize performance	`optimize-performance`
Create engine	`create-engine`
Review code	`code-review`
Respond to feedback	`respond-to-review`
Setup CI/CD	(roadmap — `setup-ci-cd`)
Not sure	`skill-router`

Proposed New Skills (Roadmap)

Skill	Priority	Status
setup-ci-cd	🔴 Critical	Not yet implemented

Index by Category

Skills are organized in category folders (skills/<category>/) with frequent entry points at root.

API

Skill	Path	Description
generate-api-collection	`skills/api/generate-api-collection/`	Generate Postman collections for REST APIs
implement-graphql	`skills/api/implement-graphql/`	Schema design, N+1 prevention, auth
integrate-api-client	`skills/api/integrate-api-client/`	Layered architecture for external APIs

Context

Skill	Path	Description
load-context	`skills/context/load-context/`	Load minimum context before coding
setup-environment	`skills/context/setup-environment/`	Complete dev environment setup

Code Quality

Skill	Path	Description
code-review	`skills/code-quality/code-review/`	Systematic Rails PR review
respond-to-review	`skills/code-quality/respond-to-review/`	Respond to review feedback
review-architecture	`skills/code-quality/review-architecture/`	Structural boundary review
security-check	`skills/code-quality/security-check/`	Deep security audit
apply-stack-conventions	`skills/code-quality/apply-stack-conventions/`	Stack-specific conventions
apply-code-conventions	`skills/code-quality/apply-code-conventions/`	DRY/YAGNI/PORO/CoC/KISS by path
implement-authorization	`skills/code-quality/implement-authorization/`	Pundit/CanCanCan, roles, permissions
refactor-code	`skills/code-quality/refactor-code/`	Refactor preserving behavior

DDD

Skill	Path	Description
define-domain-language	`skills/ddd/define-domain-language/`	Domain terms glossary
review-domain-boundaries	`skills/ddd/review-domain-boundaries/`	Review bounded contexts
model-domain	`skills/ddd/model-domain/`	Map DDD to Rails

Engines

Skill	Path	Description
create-engine	`skills/engines/create-engine/`	Rails engine scaffolding
test-engine	`skills/engines/test-engine/`	Engine testing setup
review-engine	`skills/engines/review-engine/`	Complete engine review
release-engine	`skills/engines/release-engine/`	Versioned engine release
document-engine	`skills/engines/document-engine/`	Engine documentation
create-engine-installer	`skills/engines/create-engine-installer/`	Install generators
extract-engine	`skills/engines/extract-engine/`	Extract code to engine
upgrade-engine	`skills/engines/upgrade-engine/`	Cross-version compatibility

Infrastructure

Skill	Path	Description
review-migration	`skills/infrastructure/review-migration/`	Safe migrations for production
implement-background-job	`skills/infrastructure/implement-background-job/`	Active Job, Solid Queue, Sidekiq
seed-database	`skills/infrastructure/seed-database/`	Fixtures vs Seeds
optimize-performance	`skills/infrastructure/optimize-performance/`	N+1s, profiling, caching
version-api	`skills/infrastructure/version-api/`	REST API versioning
implement-hotwire	`skills/infrastructure/implement-hotwire/`	Turbo/Stimulus integration

Orchestration

Skill	Path	Description
skill-router	`skills/orchestration/skill-router/`	Routes to correct specialized skill

Patterns

Skill	Path	Description
create-service-object	`skills/patterns/create-service-object/`	`.call` pattern, response contract
implement-calculator-pattern	`skills/patterns/implement-calculator-pattern/`	Variant-based calculators
write-yard-docs	`skills/patterns/write-yard-docs/`	Inline documentation with YARD

Planning

Skill	Path	Description
create-prd	`skills/planning/create-prd/`	Generate PRD with goals, user stories
generate-tasks	`skills/planning/generate-tasks/`	Convert PRD into TDD-ready tasks
plan-tickets	`skills/planning/plan-tickets/`	Create tickets in issue tracker

Testing

Skill	Path	Description
write-tests	`skills/testing/write-tests/`	TDD discipline, spec types
test-service	`skills/testing/test-service/`	Service object specific testing
plan-tests	`skills/testing/plan-tests/`	Choose the best first failing spec
triage-bug	`skills/testing/triage-bug/`	Bug diagnosis and reproduction

Workflows

Skill	Path	Description
tdd-workflow	`workflows/tdd-workflow/`	TDD feature loop: test → implement → review → PR
review-workflow	`workflows/review-workflow/`	Systematic PR review: review → deep dive → response
setup-workflow	`workflows/setup-workflow/`	Project setup: context → onboarding → CI/CD
quality-workflow	`workflows/quality-workflow/`	Quality check: conventions → refactor → docs
engine-workflow	`workflows/engine-workflow/`	Engine development: author → test → review → release

evals

mcp_server

skills

workflows

README.md

server.json

tile.json

igmarin/rails-agent-skills

skill-catalog.mddocs/reference/

Skill Catalog — Rails Agent Skills

Quick Navigation

Index by Stage

00 — Discovery & Context

10 — Planning & Design

20 — Setup & Configuration

30 — Development

40 — Code Quality

50 — Review & Validation

60 — Engines

Skills by Objective (Quick Lookup)

If you need...

Proposed New Skills (Roadmap)

See also

Index by Category

API

Context

Code Quality

DDD

Engines

Infrastructure

Orchestration

Patterns

Planning

Testing

Workflows

igmarin/rails-agent-skills

skill-catalog.md.css-3qkkll{font-size:var(--chakra-font-sizes-sm);font-weight:var(--chakra-font-weights-normal);color:var(--chakra-colors-gray-300);}docs/reference/

Skill Catalog — Rails Agent Skills

Quick Navigation

Index by Stage

00 — Discovery & Context

10 — Planning & Design

20 — Setup & Configuration

30 — Development

40 — Code Quality

50 — Review & Validation

60 — Engines

Skills by Objective (Quick Lookup)

If you need...

Proposed New Skills (Roadmap)

See also

Index by Category

API

Context

Code Quality

DDD

Engines

Infrastructure

Orchestration

Patterns

Planning

Testing

Workflows

skill-catalog.mddocs/reference/