Skip to content
Back to search

37signals-skills

Unofficial agent skills + reference guide that teach AI coding assistants to write Rails the 37signals way — extracted from Fizzy, Campfire, and DHH's code reviews

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/marckohlbrugge--37signals-skills/badge.svg)](/listings/marckohlbrugge--37signals-skills)

HTML

<a href="/listings/marckohlbrugge--37signals-skills"><img src="/api/listings/marckohlbrugge--37signals-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code

Copy the skills you want into your personal or project skills directory:

git clone https://github.com/marckohlbrugge/37signals-skills.git

# Personal (all projects)
cp -R 37signals-skills/skills/* ~/.claude/skills/

# Or per-project
cp -R 37signals-skills/skills/* your-app/.claude/skills/

Then ask for a review with `/dhh`, or just write Rails code — the core skill activates automatically.

Cursor

# Per-project
cp -R 37signals-skills/skills/* your-app/.cursor/skills/

Codex

Copy the skills into your global Codex skills directory:

git clone https://github.com/marckohlbrugge/37signals-skills.git
mkdir -p ~/.agents/skills
cp -R 37signals-skills/skills/* ~/.agents/skills/

Codex can invoke skills explicitly with `$skill-name` (for example, `$dhh`) or automatically when a task matches the skill description. Restart Codex if the new skills do not appear.

Other agents

Each skill is a plain `SKILL.md` with YAML frontmatter ([Agent Skills format](https://agentskills.io)). Most SKILL.md-compatible tools can load them as-is, or paste the contents into your system prompt / rules file.

Staying up to date

Clone the repo somewhere permanent and symlink instead of copying:

ln -s "$(pwd)/37signals-skills/skills/"* ~/.claude/skills/

For Codex:

mkdir -p ~/.agents/skills
ln -s "$(pwd)/37signals-skills/skills/"* ~/.agents/skills/

Then `git pull` to get updates.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 141 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # 37signals Skills
  2. Agent skills and a reference guide that teach AI coding assistants to write Rails the 37signals way — extracted from Fizzy, Campfire, and 100+ of DHH's code reviews.
  3. > **Unofficial.** This is a community project based on 37signals' public code and discussions — not affiliated with or endorsed by 37signals.
  4. Drop the skills into Claude Code or Cursor and your agent starts applying the same patterns 37signals uses: rich domain models over service objects, state as records, CRUD-everything routing, fixtures over factories, vanilla Rails over gems.
  5. ## The Skills
  6. | Skill | What it covers | Invocation |
  7. |---|---|---|
  8. | [`rails-best-practices-core`](skills/rails-best-practices-core/SKILL.md) | Architecture, naming, modeling patterns, REST routing, authorization — the baseline for all Rails work | Automatic |
  9. | [`rails-hotwire-realtime`](skills/rails-hotwire-realtime/SKILL.md) | Turbo Streams/Frames, morphing, Stimulus, ActionCable, presence, optimistic UI, web push | On demand |
  10. | [`rails-jobs`](skills/rails-jobs/SKILL.md) | Active Job design, `_later`/`_now` conventions, Solid Queue, recurring tasks, retry policy | On demand |
  11. | [`rails-migrations`](skills/rails-migrations/SKILL.md) | Safe schema changes, staged rollouts, script backfills, multi-DB/multi-adapter setups | On demand |
  12. | [`rails-security-multitenancy`](skills/rails-security-multitenancy/SKILL.md) | Path-based tenancy, Identity→Session→User auth, scoped lookups, SSRF, CSRF, rate limiting | On demand |
  13. | [`rails-testing`](skills/rails-testing/SKILL.md) | Minitest + fixtures, coverage budget, Turbo/broadcast assertions, multi-tenant test wiring | On demand |
  14. | [`rails-webhooks`](skills/rails-webhooks/SKILL.md) | Outbox delivery, failure classification, delinquency circuit breakers, payload signing | On demand |
  15. | [`dhh`](skills/dhh/SKILL.md) | Review code like DHH would — direct, opinionated, allergic to over-engineering | `/dhh` |
  16. "On demand" skills are marked `disable-model-invocation: true` so they don't bloat every request — invoke them explicitly (e.g. as a slash command) or let the core skill point to them.
  17. ## Installation
  18. ### Claude Code
  19. Copy the skills you want into your personal or project skills directory:
  20. ```bash
  21. git clone https://github.com/marckohlbrugge/37signals-skills.git
  22. # Personal (all projects)
  23. cp -R 37signals-skills/skills/* ~/.claude/skills/
  24. # Or per-project
  25. cp -R 37signals-skills/skills/* your-app/.claude/skills/
  26. ```
  27. Then ask for a review with `/dhh`, or just write Rails code — the core skill activates automatically.
  28. ### Cursor
  29. ```bash
  30. # Per-project
  31. cp -R 37signals-skills/skills/* your-app/.cursor/skills/
  32. ```
  33. ### Codex
  34. Copy the skills into your global Codex skills directory:
  35. ```bash
  36. git clone https://github.com/marckohlbrugge/37signals-skills.git
  37. mkdir -p ~/.agents/skills
  38. cp -R 37signals-skills/skills/* ~/.agents/skills/
  39. ```
  40. Codex can invoke skills explicitly with `$skill-name` (for example, `$dhh`) or automatically when a task matches the skill description. Restart Codex if the new skills do not appear.
  41. ### Other agents
  42. Each skill is a plain `SKILL.md` with YAML frontmatter ([Agent Skills format](https://agentskills.io)). Most SKILL.md-compatible tools can load them as-is, or paste the contents into your system prompt / rules file.
  43. ### Staying up to date
  44. Clone the repo somewhere permanent and symlink instead of copying:
  45. ```bash
  46. ln -s "$(pwd)/37signals-skills/skills/"* ~/.claude/skills/
  47. ```
  48. For Codex:
  49. ```bash
  50. mkdir -p ~/.agents/skills
  51. ln -s "$(pwd)/37signals-skills/skills/"* ~/.agents/skills/
  52. ```
  53. Then `git pull` to get updates.
  54. ## The Guide
  55. The skills are distilled from a longer-form reference covering ~35 topics, kept in [`guide/`](guide/). It was extracted from analyzing 265 pull requests in 37signals' Fizzy codebase — not just the final code, but the reviews, trade-offs, and iterations that led to it.
  56. **Core Rails:** [Routing](guide/routing.md) · [Controllers](guide/controllers.md) · [Models](guide/models.md) · [Views](guide/views.md)
  57. **Frontend:** [Hotwire](guide/hotwire.md) · [Stimulus](guide/stimulus.md) · [CSS](guide/css.md) · [Accessibility](guide/accessibility.md) · [Mobile](guide/mobile.md)
  58. **Backend:** [Authentication](guide/authentication.md) · [Multi-Tenancy](guide/multi-tenancy.md) · [Database](guide/database.md) · [Background Jobs](guide/background-jobs.md) · [Caching](guide/caching.md) · [Performance](guide/performance.md)
  59. **Real-time & Communication:** [ActionCable](guide/actioncable.md) · [Notifications](guide/notifications.md) · [Email](guide/email.md)
  60. **Features:** [Webhooks](guide/webhooks.md) · [Workflows](guide/workflows.md) · [Watching](guide/watching.md) · [Filtering](guide/filtering.md) · [AI/LLM Integration](guide/ai-llm.md)
  61. **Rails Components:** [Active Storage](guide/active-storage.md) · [Action Text](guide/action-text.md)
  62. **Infrastructure & Testing:** [Security Checklist](guide/security-checklist.md) · [Testing](guide/testing.md) · [Configuration](guide/configuration.md) · [Observability](guide/observability.md)
  63. **Philosophy & People:** [Development Philosophy](guide/development-philosophy.md) · [What They Avoid](guide/what-they-avoid.md) · [DHH](guide/dhh.md) · [Jason Zimdars](guide/jason-zimdars.md) · [Jorge Manrubia](guide/jorge-manrubia.md)
  64. ## Quick Start: The 37signals Way
  65. 1. **Rich domain models** over service objects
  66. 2. **CRUD controllers** over custom actions
  67. 3. **Concerns** for horizontal code sharing
  68. 4. **Records as state** over boolean columns
  69. 5. **Database-backed everything** (no Redis)
  70. 6. **Build it yourself** before reaching for gems
  71. 7. **Ship to learn** - prototype quality is valid
  72. 8. **Vanilla Rails is plenty** - maximize what Rails gives you
  73. ## Important Caveats
  74. **LLM-Generated Content**: This guide and these skills were largely produced by an LLM (Claude) analyzing source code, PR descriptions, and code snippets. There may be hallucinations or inaccuracies. Take everything with a grain of salt and verify against actual implementations.
  75. **Code License**: Code examples extracted from Fizzy are licensed under the [O'Saasy License](https://osaasy.dev). Please review that license before using code snippets in your projects.
  76. ## Acknowledgements
  77. - **[37signals](https://37signals.com)** for open-sourcing their codebases and giving the community a window into how they build software
  78. - **[Rob Zolkos](https://www.zolkos.com/2025/12/10/fizzys-pull-requests)** for his work identifying and cataloging the most educational PRs
  79. - **[Claude Code](https://claude.com/claude-code)** for creating this guide through iterative deep-dive research sessions
  80. ## Further Reading
  81. - [Fizzy Source Code](https://github.com/basecamp/fizzy) - The official Fizzy repository with full git history
  82. - [Campfire Source Code](https://github.com/basecamp/once-campfire) - 37signals' open-source chat application, another reference implementation
  83. - [Fizzy's Pull Requests: Who Built What and How](https://www.zolkos.com/2025/12/10/fizzys-pull-requests) - Curated PR sequences organized by topic
  84. - [Fizzy JS Patterns](https://www.driftingruby.com/episodes/fizzy-js-patterns) - Drifting Ruby episode analyzing JavaScript patterns in Fizzy
  85. - [Read The Friendly Source Code](https://beautifulruby.com/code/fizzy) - Beautiful Ruby code review covering architecture and security observations
  86. - [Writebook by ONCE](https://igor.works/blog/writebook-by-once) - Code walkthrough of another 37signals open-source project
  87. - [On Writing Software Well](https://www.youtube.com/playlist?list=PL9wALaIpe0Py6E_oHCgTrD6FvFETwJLlx) - DHH's screencast series on software development practices
  88. ## Disclaimer
  89. This is an unofficial project created by analyzing publicly available code and discussions. It is not affiliated with or endorsed by 37signals.
  90. ## License
  91. Code examples extracted from Fizzy are licensed under the [O'Saasy License](https://osaasy.dev). All analysis, commentary, skills, and original content in this repo is licensed under MIT.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.