inertia-rails-skills

Claude Code plugin that corrects common anti-patterns when building Rails + Inertia.js applications with React, Vue 3, or Svelte.

What it corrects

Claude's training data contains outdated or wrong patterns for the Inertia Rails stack. This plugin fixes the most impactful ones:

Anti-pattern	Correction
`redirect_to` for external URLs (Stripe, OAuth)	`inertia_location(url)`
Third-party form libraries (`react-hook-form`, `zod`, etc.) with Inertia	`<Form>` component or `useForm` hook
Old `PageProps extends SharedProps` typing	`InertiaConfig` module augmentation
`useEffect` + `fetch` for page data	Server-rendered props via controller
`next-themes` / `use client` in shadcn	Vite-compatible patterns

Skill	Purpose
`inertia-rails-architecture`	Mental model, decision matrices, anti-pattern detection
`inertia-rails-setup`	Detects stack and framework, offers recommended deps, generates CLAUDE.md config
`inertia-rails-controllers`	Rails controller patterns for Inertia responses
`inertia-rails-forms`	Form handling with `<Form>` component and `useForm` hook (React inline; Vue/Svelte references)
`inertia-rails-pages`	Page components, layouts, navigation, client-side APIs (React inline; Vue/Svelte references)
`inertia-rails-typescript`	InertiaConfig module augmentation for shared props, flash, error typing
`shadcn-inertia`	shadcn/ui patterns adapted for Inertia + React (not Next.js)
`shadcn-vue-inertia`	shadcn-vue patterns adapted for Inertia + Vue 3
`shadcn-svelte-inertia`	shadcn-svelte patterns adapted for Inertia + Svelte
`alba-inertia`	Alba serializer patterns with Typelizer auto-generated types
`inertia-rails-testing`	RSpec and Minitest matchers for Inertia responses

npx skills add inertia-rails/skills

Rails 8+ with inertia-rails 3.17+
React: @inertiajs/react 2.3+ with React 19+
Vue 3: @inertiajs/vue3 2.3+ with Vue 3.5+
Svelte: @inertiajs/svelte 2.3+ with Svelte 5+ (Svelte 4 notes included)
TypeScript
Tailwind CSS v4
shadcn/ui (React), shadcn-vue (Vue), or shadcn-svelte (Svelte) — all Vite setup, not SSR framework defaults

MIT