Back to Skills

using-rails-ai

verified

Rails-AI introduction - explains how rails-ai (Rails domain layer) integrates with superpowers (universal workflows) for Rails development

View on GitHub

Marketplace

rails-ai-marketplace

zerobearing2/rails-ai

Plugin

rails-ai

Repository

zerobearing2/rails-ai
20stars

skills/using-rails-ai/SKILL.md

Last Verified

January 21, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/zerobearing2/rails-ai/blob/main/skills/using-rails-ai/SKILL.md -a claude-code --skill using-rails-ai

Installation paths:

Claude
.claude/skills/using-rails-ai/
Powered by add-skill CLI

Instructions

# Using Rails-AI: Rails Domain Layer on Superpowers Workflows

<EXTREMELY-IMPORTANT>
## ⚠️ DEPENDENCY CHECK: Superpowers Required

**Rails-AI requires the Superpowers plugin to function.**

Before starting ANY work, verify Superpowers is installed by attempting to use a Superpowers skill. If you see an error like "skill not found" or "plugin not available":

**⚠️ WARNING: Superpowers plugin not installed!**

Rails-AI cannot function without Superpowers. Please install it:

```
/plugin marketplace add obra/superpowers
/plugin install superpowers
```

Then restart Claude Code.

**Why this matters:** Rails-AI provides WHAT to build (Rails domain knowledge). Superpowers provides HOW to build it (TDD, debugging, planning, code review). Without Superpowers, you cannot follow the mandatory workflows.

If Superpowers is installed, proceed normally.

## MANDATORY: Use Superpowers Foundation First

**Rails-AI builds on Superpowers. You MUST use the foundation before doing ANY work.**

**FIRST ACTION when starting any Rails work:**
1. Use `superpowers:using-superpowers` skill (Skill tool)
2. This establishes mandatory skill-usage protocol
3. Then use relevant rails-ai domain skills (see table below)

**Why use superpowers:using-superpowers?**
- Enforces checking for skills BEFORE any task
- Establishes discipline of using skills with Skill tool
- Prevents rationalizing away skill usage
- Provides proven workflow framework

**Without using superpowers:using-superpowers first:**
- You will skip using skills when you should
- You will rationalize that tasks are "too simple" for skills
- You will operate without the proven process framework

## Rails-AI Skill-to-Task Mapping

**Superpowers handles skill-usage enforcement. This table tells you WHICH Rails skills to use:**

| User Request Involves | Use These Skills |
|----------------------|-------------------|
| Models, databases, ActiveRecord | rails-ai:models |
| Controllers, routes, REST | rails-ai:controllers |
| Views, templa

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
12733 chars