Agent Skills for Ruby & Rails

A curated collection of AI agent skills for Ruby, Rails, and SaaS development.

Quick Start

Any Agent (Cursor, OpenAI Codex, Gemini CLI, etc.)

npx add-skill aviflombaum/claude-code-in-avinyc

Claude Code

# Add marketplace and install all plugins
/plugin marketplace add aviflombaum/claude-code-in-avinyc

# Or install individual plugins
/plugin install git-workflows@claude-code-in-avinyc
/plugin install design-system@claude-code-in-avinyc
/plugin install saas-metrics@claude-code-in-avinyc
/plugin install tech-writer@claude-code-in-avinyc
/plugin install compound-analyzer@claude-code-in-avinyc
/plugin install plan-interview@claude-code-in-avinyc
/plugin install qmd@claude-code-in-avinyc
/plugin install warp-rails@claude-code-in-avinyc
/plugin install monitor-config@claude-code-in-avinyc

Available Plugins

🛤️ Development Tools

Plugin	Skills	Description
git-workflows	`/avinyc:commit`, `/avinyc:rails-worktree`	Git commits and worktrees
qmd	`/avinyc:qmd-search`, `/avinyc:qmd-configure`, `/avinyc:qmd-doctor`, `/avinyc:qmd-status`	Semantic search for project docs

🎨 Design & UX

Plugin	Skills	Description
design-system	`/avinyc:web-design`, `avinyc:ux-ui` (auto)	Visual design and usability

📊 Business & Writing

Plugin	Skills	Description
saas-metrics	`/avinyc:business`, `/avinyc:marketing`	LTV, CAC, funnels
tech-writer	`/avinyc:write`	Blog posts and tutorials

⚡ Productivity

Plugin	Skills	Description
compound-analyzer	`/avinyc:analyze`	Find automation opportunities
plan-interview	`/avinyc:interview`	Socratic plan refinement

🖥️ System & Terminal

Plugin	Skills	Description
warp-rails	`/avinyc:warp-bootstrap`	Bootstrap Warp terminal for Rails
monitor-config	`/avinyc:monitor-config`	Optimize multi-monitor setups

Plugin Details

git-workflows

Git commit assistant and worktree management for Rails projects.

# Create logical commits
/avinyc:commit

# Create an isolated worktree
/avinyc:rails-worktree feature-branch

/avinyc:commit: Analyzes git changes and creates logical, well-structured commits using conventional commit format.

/avinyc:rails-worktree: Creates git worktrees with automatic Rails credential symlinking (master.key, environment keys).

qmd

Semantic search and management for project documentation using qmd.

# Search project docs
/avinyc:qmd-search how does authentication work

# Configure collections
/avinyc:qmd-configure

# Health check
/avinyc:qmd-doctor

# Show status
/avinyc:qmd-status

design-system

UI/UX design expertise for building beautiful, usable interfaces.

# Design a landing page
/avinyc:web-design hero section for a SaaS product

# UX knowledge auto-triggers when discussing usability
"What's the best information architecture for a settings page?"

/avinyc:web-design: Visual hierarchy, typography, color theory, layout systems, design aesthetics (Bauhaus, Retro, Futuristic)

avinyc:ux-ui (auto-triggered): Usability principles, accessibility, interaction design, information architecture

saas-metrics

SaaS business metrics for founders building products.

# Analyze unit economics
/avinyc:business calculate LTV:CAC ratio

# Model a marketing funnel
/avinyc:marketing ad spend to conversion analysis

/avinyc:business: LTV, CAC, MRR/ARR, churn analysis, payback period, Rule of 40

/avinyc:marketing: CPM, CPC, conversion funnels, landing page optimization, waitlist economics

tech-writer

Write technical content with Flatiron School's engaging teaching style.

# Write a blog post
/avinyc:write blog "How to implement Action Cable"

# Create a tutorial
/avinyc:write tutorial "Building a Rails API"

Style: Technically unimpeachable yet refreshingly human. Strong opinions, loosely held. Clarity through progression.

compound-analyzer

Identify automation and systematization opportunities in your development work.

# Analyze completed work
/avinyc:analyze

# Or describe what to review
"Analyze this feature for automation opportunities"

Identifies: Delegation opportunities, automation candidates, pattern extraction, workflow systematization

plan-interview

Refine project plans through in-depth Socratic questioning.

# Interview about a plan
/avinyc:interview path/to/plan.md

Questions cover: Technical implementation, UI/UX considerations, edge cases, tradeoffs, assumptions

warp-rails

Bootstrap Warp terminal configuration for Rails projects with colored tabs.

# Set up Warp for current project
/avinyc:warp-bootstrap

Creates launch config with tabs:

Server (green) — bin/dev or rails server
Claude (blue) — Claude Code session
Shell (yellow) — Empty terminal
Console (magenta) — Rails console
Logs (cyan) — Tail development log
Jobs (red) — Background processor (if detected)

Auto-detects: bin/dev, Sidekiq, GoodJob, SolidQueue

monitor-config

Configure and optimize multi-monitor setups on macOS using displayplacer.

# Configure your monitors
/avinyc:monitor-config

# Or describe your setup
"Optimize my monitors for coding with a vertical display on the left"

Interactive workflow:

Discovers connected displays
Interviews about physical arrangement
Asks about use case (coding, media, gaming)
Recommends optimal resolutions and refresh rates
Applies configuration and saves reusable profiles

Supports: 4K displays, portrait/landscape orientation, 120Hz refresh rates, multi-monitor arrangements

Local Development

Test plugin changes locally before pushing:

# One-time setup
./scripts/setup-local-dev.sh

# Verify configuration
./scripts/validate-settings.sh
./scripts/validate-versions.sh

This configures Claude Code to load plugins from your local directory instead of GitHub. See AGENTS.md for details.

Contributing

Fork the repository
Run ./scripts/setup-local-dev.sh to configure local testing
Create your plugin in plugins/<plugin-name>/
Add .claude-plugin/plugin.json manifest
Add skills under skills/<skill-name>/SKILL.md
Register in .claude-plugin/marketplace.json
Bump version with ./scripts/bump-version.sh <plugin-name> patch (required for updates to propagate)
Submit a pull request

License

MIT

Name	worktree
Description	This skill should be used when the user asks to "create a worktree", "new worktree", "worktree for feature", "git worktree", or needs to work on a feature branch in isolation. Handles Rails credential symlinking automatically.

worktree

SKILL.md