agent-skills

Agent Skills

A plugin-first skill repo for four jobs:

• plugins/rails-37signals-patterns/ for focused 37signals-style Rails specialists
• plugins/rails-37signals-workflows/ for workflow-level Rails implementation, refactoring, and review
• plugins/fizzy/ for self-hosted Fizzy workflows via the upstream CLI
• plugins/rcc/ for RCC automation, isolated environments, and robot scaffolding

The canonical source of truth lives under plugins/. The repo exposes a generated top-level skills/ view for humans and standalone installers, plus .agents/skills/ for in-repo agent discovery.

Structure

agent-skills/
├── AGENTS.md
├── README.md
├── .agents/
│   ├── plugins/
│   │   └── marketplace.json
│   └── skills/
├── .claude-plugin/
│   └── marketplace.json
├── marketplaces/
│   └── catalog.json
├── plugins/
│   ├── rails-37signals-patterns/
│   │   ├── .codex-plugin/
│   │   ├── .claude-plugin/
│   │   └── skills/
│   ├── rails-37signals-workflows/
│   │   ├── .codex-plugin/
│   │   ├── .claude-plugin/
│   │   └── skills/
│   ├── fizzy/
│   │   ├── .codex-plugin/
│   │   ├── .claude-plugin/
│   │   └── skills/
│   └── rcc/
│       ├── .codex-plugin/
│       ├── .claude-plugin/
│       └── skills/
├── scripts/
│   ├── build_marketplaces.py
│   ├── build_runtime_views.py
│   └── validate_repo.py
└── skills/  # generated standalone symlinks

Skills

Rails 37signals Patterns

The plugins/rails-37signals-patterns/skills/37signals-* skills cover focused Rails patterns and conventions inspired by 37signals-style applications. Across the set, the defaults lean toward rich models, CRUD resources, Hotwire, Solid Queue, explicit Current.account scoping, UUID-backed schemas, and Minitest with fixtures.

Architecture and workflow

• 37signals-implement — orchestrates complete Rails feature work across the specialist skills.
• 37signals-refactoring — orchestrates incremental refactors toward 37signals Rails patterns.
• 37signals-review — reviews Rails code for convention alignment, CRUD shape, model design, and Hotwire fit.

Domain, data, and tenancy

• 37signals-auth — custom passwordless authentication without Devise.
• 37signals-concerns — shared model and controller behavior via focused concerns.
• 37signals-migration — UUID-first, account-scoped migrations without foreign key constraints.
• 37signals-model — rich domain models with business logic, scopes, validations, and associations.
• 37signals-multi-tenant — URL-based multi-tenancy and explicit account scoping.
• 37signals-state-records — models business state as records instead of booleans.

Delivery, UI, and operations

• 37signals-api — REST APIs using respond_to blocks with Jbuilder templates.
• 37signals-caching — HTTP caching, ETags, fresh_when, stale?, and fragment caching.
• 37signals-crud — RESTful controllers built around the “everything is CRUD” philosophy.
• 37signals-events — event tracking, activity feeds, and webhook-friendly event models.
• 37signals-jobs — shallow background jobs and async workflows using Solid Queue.
• 37signals-mailer — minimal Action Mailer patterns and bundled notifications.
• 37signals-stimulus — focused Stimulus controllers for progressive enhancement.
• 37signals-test — Minitest and fixtures for fast, readable Rails test coverage.
• 37signals-turbo — Turbo Streams, Frames, and morphing for real-time UI updates.

These specialist skills preserve source metadata in their frontmatter and were adapted from the broader rails_ai_agents 37signals pattern set.

Rails 37signals Workflows