Implementation Guide — Rails Agent Skills

Step-by-step install and verification for the rails-agent-skills repository on each supported platform.

• What this library is: README
• How to chain skills: workflow-guide.md
• Skill file conventions: architecture.md

The recommended way to use this library is via the MCP Server Approach. The primary path is the embedded Ruby/Bundler server in this repo. Docker remains available as a fallback for environments that do not want local Ruby setup.

MCP Server (Recommended)

The MCP server exposes docs and workflows as resources and loads skills on demand through the use_skill tool.

For complete MCP setup instructions, exact host-specific config snippets, and troubleshooting, see mcp_server/README.md. That file is the canonical source of truth for MCP setup.

Local Ruby/Bundler (Primary)

Clone the repo and install the MCP server dependencies:

git clone https://github.com/igmarin/rails-agent-skills.git ~/skills/rails-agent-skills
cd ~/skills/rails-agent-skills/mcp_server
bundle install

Then configure your MCP host with the exact template from mcp_server/README.md. In Claude Code, opening the repo already picks up the bundled root .mcp.json.

Docker fallback

If you do not want to manage a local Ruby toolchain, use the Docker fallback documented in mcp_server/README.md. Treat Docker as the fallback path; local Ruby/Bundler remains the primary setup for this repo.

Alternative: The Symlink Approach (Legacy)

If you cannot use MCP, you can symlink the CLAUDE.md or GEMINI.md files to your agent's global configuration directory.

Claude Code

ln -sf ~/skills/rails-agent-skills/CLAUDE.md ~/.claude/CLAUDE.md

Gemini CLI

ln -s ~/skills/rails-agent-skills/GEMINI.md ~/.gemini/GEMINI.md

Session Start Hook

The session-start hook automatically injects the skill-router bootstrap skill at the beginning of each session.

Troubleshooting