rails_claude_skills 0.1.0

data/lib/generators/claude/command/command_generator.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+
+module Claude
+  module Generators
+    class CommandGenerator < Rails::Generators::NamedBase
+      source_root File.expand_path("templates", __dir__)
+
+      class_option :description, type: :string, default: nil,
+                                 desc: "Command description"
+      class_option :argument_hint, type: :string, default: nil,
+                                   desc: "Argument hint for command usage"
+      class_option :allowed_tools, type: :string, default: "Bash, Read, Edit, Write",
+                                   desc: "Comma-separated list of allowed tools"
+
+      def create_command_file
+        template "command.md.tt", command_path
+      end
+
+      def show_instructions
+        say "\nCommand '#{file_name}' created successfully!", :green
+        say "\nLocation: #{command_path}", :blue
+        say "\nUsage: /#{file_name}", :yellow
+        say "\nNext steps:", :yellow
+        say "  1. Edit #{command_path} to add your command logic"
+        say "  2. Test with: /#{file_name}"
+        say "  3. The command will be auto-loaded by Claude\n"
+      end
+
+      private
+
+      def command_path
+        ".claude/commands/#{file_name}.md"
+      end
+
+      def command_description
+        options[:description] || "#{file_name.titleize} command"
+      end
+
+      def argument_hint
+        options[:argument_hint] || "[arguments]"
+      end
+
+      def allowed_tools
+        options[:allowed_tools]
+      end
+    end
+  end
+end

data/lib/generators/claude/command/templates/command.md.tt

@@ -0,0 +1,28 @@
+---
+description: <%= command_description %>
+<% if argument_hint %>argument-hint: <%= argument_hint %><% end %>
+allowed-tools: <%= allowed_tools %>
+---
+
+## <%= file_name.titleize %>
+
+Add your command instructions here.
+
+Use $ARGUMENTS to reference all arguments passed to the command.
+Use $1, $2, etc. to reference specific arguments by position.
+
+### Example Usage
+
+```
+/<%= file_name %> <%= argument_hint %>
+```
+
+### Steps
+
+1. Step 1
+2. Step 2
+3. Step 3
+
+### Notes
+
+Add any important notes or considerations here.

data/lib/generators/claude/commands_library/create-pr.md

@@ -0,0 +1,27 @@
+---
+description: Create a branch, commit changes, and open a pull request
+argument-hint: [branch_name] [commit_message] [pr_title]
+allowed-tools: Bash
+---
+
+Create a pull request workflow for: $ARGUMENTS
+
+Steps:
+1. ✅ Check for uncommitted changes
+2. ✅ Create and checkout new branch
+3. ✅ Stage all changes
+4. ✅ Create commit with descriptive message
+5. ✅ Push to remote
+6. ✅ Create pull request using gh CLI
+7. ✅ Display PR URL
+
+Commit message format:
+```
+{commit_message}
+
+🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
+Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
+```
+
+Note: Requires GitHub CLI (`gh`) to be installed and authenticated.

data/lib/generators/claude/commands_library/dbchange.md

@@ -0,0 +1,19 @@
+---
+description: Generate a database migration with safety checks
+argument-hint: [migration_description]
+allowed-tools: Bash, Read, Edit
+---
+
+Generate a migration: $ARGUMENTS
+
+Safety checklist:
+1. ✅ Use reversible migrations when possible
+2. ✅ Add indexes for foreign keys
+3. ✅ Use `change` method instead of up/down when possible
+4. ✅ Consider data migration needs
+5. ✅ Add comments for complex changes
+
+After generation:
+- Review the migration file
+- Check for potential downtime issues
+- Suggest background migration if needed for large tables

data/lib/generators/claude/commands_library/quality.md

@@ -0,0 +1,20 @@
+---
+description: Run RuboCop, Brakeman, and security audits
+allowed-tools: Bash
+---
+
+## Current Code Quality
+
+**RuboCop (Style):**
+!`bundle exec rubocop`
+
+**Brakeman (Security):**
+!`bundle exec brakeman -q`
+
+**Bundler Audit (Gem Vulnerabilities):**
+!`bundle exec bundler-audit check --update`
+
+Analyze the results above and:
+1. Summarize any violations or vulnerabilities
+2. Suggest fixes for critical issues
+3. Offer to auto-fix RuboCop issues if needed

data/lib/generators/claude/commands_library/stimulus.md

@@ -0,0 +1,19 @@
+---
+description: Generate a new Stimulus controller with proper setup
+argument-hint: [controller_name]
+allowed-tools: Bash, Write, Edit, Read
+---
+
+Generate a Stimulus controller: $ARGUMENTS
+
+Steps:
+1. Generate the controller: `rails g stimulus $ARGUMENTS`
+2. Add example actions and targets
+3. Show usage example in HTML
+4. Follow Stimulus naming conventions
+
+Best practices:
+- Use data-controller for registration
+- Use data-action for event bindings
+- Use data-*-target for element references
+- Keep controllers focused and single-purpose

data/lib/generators/claude/commands_library/turbo-feature.md

@@ -0,0 +1,17 @@
+---
+description: Build a new feature using Hotwire (Turbo + Stimulus)
+argument-hint: [feature_description]
+allowed-tools: Write, Edit, Read, Bash, Glob
+---
+
+Build a new Hotwire-powered feature: $ARGUMENTS
+
+Requirements:
+1. Use Turbo Frames for navigation and forms
+2. Use Turbo Streams for real-time updates
+3. Add Stimulus controllers only when Turbo isn't sufficient
+4. Style with Tailwind CSS utility classes
+5. Follow RESTful routing conventions
+6. Include tests
+
+Analyze the existing codebase patterns first, then implement following Rails + Hotwire best practices.

data/lib/generators/claude/install/install_generator.rb

@@ -0,0 +1,211 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+
+module Claude
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+
+      class_option :preset, type: :string, default: "basic",
+                            desc: "Preset bundle (basic, fullstack, api)"
+      class_option :skip_agents, type: :boolean, default: false,
+                                 desc: "Don't create default agents"
+      class_option :skip_readme, type: :boolean, default: false,
+                                 desc: "Don't create README"
+
+      def create_claude_directory
+        empty_directory ".claude"
+        empty_directory ".claude/skills"
+        empty_directory ".claude/agents" unless options[:skip_agents]
+        empty_directory ".claude/commands"
+        empty_directory ".claude/rules"
+      end
+
+      def copy_settings
+        template "settings.local.json.tt", ".claude/settings.local.json"
+      end
+
+      def copy_readme
+        template "README.md.tt", ".claude/README.md" unless options[:skip_readme]
+      end
+
+      def install_preset_skills
+        case options[:preset]
+        when "fullstack"
+          install_fullstack_preset
+        when "api"
+          install_api_preset
+        else
+          install_basic_preset
+        end
+      end
+
+      def show_readme
+        readme "USAGE" if behavior == :invoke
+      end
+
+      private
+
+      def install_basic_preset
+        say "Installing basic preset...", :green
+        install_basic_skills_and_rules
+        create_basic_agent unless options[:skip_agents]
+      end
+
+      def install_fullstack_preset
+        say "Installing fullstack preset...", :green
+        install_basic_skills_and_rules
+        install_skill("rails-hotwire")
+        install_skill("tailwindcss")
+        install_skill("rspec-testing")
+        install_command("quality")
+        install_command("turbo-feature")
+        install_command("stimulus")
+        install_command("create-pr")
+        install_rule("hotwire")
+        install_rule("security")
+        create_fullstack_agent unless options[:skip_agents]
+      end
+
+      def install_basic_skills_and_rules
+        install_skill("rails-models")
+        install_skill("rails-controllers")
+        install_skill("rails-views")
+        install_command("dbchange")
+        install_rule("code-style")
+        install_rule("testing")
+        install_rule("database")
+      end
+
+      def install_api_preset
+        say "Installing API preset...", :green
+        install_skill("rails-models")
+        install_skill("rails-api-controllers")
+        install_skill("rails-auth-with-devise")
+        install_skill("rspec-testing")
+        install_command("dbchange")
+        install_command("quality")
+        install_rule("code-style")
+        install_rule("testing")
+        install_rule("security")
+        install_rule("database")
+        create_api_agent unless options[:skip_agents]
+      end
+
+      def install_skill(skill_name)
+        skill_dir = ".claude/skills/#{skill_name}"
+        empty_directory skill_dir
+
+        skill_source = File.expand_path("../skills_library/#{skill_name}", __dir__)
+        if File.directory?(skill_source)
+          directory skill_source, skill_dir
+        else
+          create_file "#{skill_dir}/SKILL.md", default_skill_content(skill_name)
+        end
+      end
+
+      def install_command(command_name)
+        command_file = ".claude/commands/#{command_name}.md"
+        command_source = File.expand_path("../commands_library/#{command_name}.md", __dir__)
+
+        if File.exist?(command_source)
+          copy_file command_source, command_file
+        else
+          create_file command_file, default_command_content(command_name)
+        end
+      end
+
+      def install_rule(rule_name)
+        rule_file = ".claude/rules/#{rule_name}.md"
+        rule_source = File.expand_path("../rules_library/#{rule_name}.md", __dir__)
+
+        if File.exist?(rule_source)
+          copy_file rule_source, rule_file
+        else
+          create_file rule_file, default_rule_content(rule_name)
+        end
+      end
+
+      def create_basic_agent
+        template "agents/rails-developer.md.tt", ".claude/agents/rails-developer.md"
+      end
+
+      def create_fullstack_agent
+        template "agents/fullstack-dev.md.tt", ".claude/agents/fullstack-dev.md"
+      end
+
+      def create_api_agent
+        template "agents/api-dev.md.tt", ".claude/agents/api-dev.md"
+      end
+
+      def default_skill_content(skill_name)
+        <<~SKILL
+          ---
+          name: #{skill_name}
+          description: #{skill_name.titleize} skill
+          version: 1.0.0
+          ---
+
+          # #{skill_name.titleize}
+
+          ## Quick Reference
+
+          This skill is not yet implemented.
+
+          ## Usage
+
+          To customize this skill:
+          ```bash
+          rails g claude:views #{skill_name}
+          ```
+        SKILL
+      end
+
+      def default_command_content(command_name)
+        <<~COMMAND
+          ---
+          description: #{command_name.titleize} command
+          allowed-tools: Bash, Read, Edit, Write
+          ---
+
+          ## #{command_name.titleize}
+
+          Add your command instructions here.
+
+          Use $ARGUMENTS to reference command arguments.
+        COMMAND
+      end
+
+      def default_rule_content(rule_name)
+        <<~RULE
+          # #{rule_name.titleize} Rules
+
+          Add your project rules and guidelines here.
+
+          ## Overview
+
+          Describe the purpose of these rules.
+
+          ## Guidelines
+
+          - Add specific guidelines
+          - Include best practices
+          - Document conventions
+        RULE
+      end
+
+      def app_name
+        Rails.application.class.module_parent_name
+      rescue StandardError
+        "MyApp"
+      end
+
+      def rails_version
+        Rails::VERSION::STRING
+      rescue StandardError
+        "7.0"
+      end
+    end
+  end
+end

data/lib/generators/claude/install/templates/README.md.tt

@@ -0,0 +1,59 @@
+# Claude Skills for <%= app_name %>
+
+This directory contains Claude AI skills and agents for this Rails project.
+
+## Structure
+
+- `skills/` - Modular skill definitions
+- `agents/` - Agent configurations that load multiple skills
+- `settings.local.json` - Claude configuration
+
+## Installed Preset
+
+**<%= options[:preset].titleize %> Preset**
+
+Skills are automatically loaded when you use Claude in this project.
+
+## Usage
+
+### Customize a skill
+
+To customize an existing skill:
+```bash
+rails g claude:views <skill-name>
+```
+
+### Create a new skill
+
+To create a custom skill:
+```bash
+rails g claude:skill <skill-name>
+```
+
+### Create an agent
+
+To create a new agent:
+```bash
+rails g claude:agent <agent-name> --skills=skill1,skill2
+```
+
+## Available Commands
+
+```bash
+# List all generators
+rails g --help | grep claude
+
+# Get help for specific generator
+rails g claude:install --help
+rails g claude:skill --help
+rails g claude:agent --help
+```
+
+## Learn More
+
+- [Rails Claude Skills Documentation](https://github.com/shoebtamboli/rails_claude_skills)
+- [Claude AI Documentation](https://docs.anthropic.com/claude/)
+
+---
+
+Generated with `rails_claude_skills` v<%= RailsClaudeSkills::VERSION %>

data/lib/generators/claude/install/templates/USAGE

@@ -0,0 +1,28 @@
+===============================================================================
+
+Claude Skills have been installed successfully!
+
+Your .claude/ directory has been created with preset-specific skills, commands,
+rules, and a pre-configured agent tailored to your development stack.
+
+Next steps:
+
+  1. Review your skills in .claude/skills/
+
+  2. Customize any pre-built skill:
+     $ rails g claude:views <skill-name>
+
+  3. Create custom skills for your domain:
+     $ rails g claude:skill <skill-name>
+
+  4. Create custom agents:
+     $ rails g claude:agent <agent-name>
+
+  5. Create custom commands (slash commands):
+     $ rails g claude:command <command-name>
+
+Documentation: https://github.com/shoebtamboli/rails_claude_skills
+
+Happy coding with AI! 🚀
+
+===============================================================================

data/lib/generators/claude/install/templates/agents/api-dev.md.tt

@@ -0,0 +1,46 @@
+---
+name: api-dev
+description: Rails API development agent
+model: sonnet
+color: green
+skills:
+  - rails-models
+  - rails-api-controllers
+  - rails-serializers
+  - rails-authentication
+---
+
+# Rails API Developer
+
+You are an expert Rails API developer specializing in building robust JSON APIs.
+
+## Skills Integration
+
+This agent auto-loads:
+- **rails-models** - ActiveRecord patterns, migrations, validations
+- **rails-api-controllers** - API controller patterns, error handling
+- **rails-serializers** - JSON serialization with ActiveModel::Serializers
+- **rails-authentication** - Token-based authentication, authorization
+
+## Core Expertise
+
+- RESTful API design
+- JSON:API or custom JSON formats
+- Token-based authentication (JWT, API keys)
+- API versioning strategies
+- Error handling and status codes
+- Rate limiting and throttling
+- API documentation
+
+## Development Workflow
+
+1. **Design API** - Plan endpoints, resources, and data structures
+2. **Define Routes** - Set up RESTful routing with versioning
+3. **Build Models** - Create ActiveRecord models with validations
+4. **Implement Controllers** - Handle requests, responses, errors
+5. **Serialize Data** - Format JSON responses consistently
+6. **Secure API** - Add authentication and authorization
+7. **Document** - Provide clear API documentation
+8. **Test** - Write comprehensive request specs
+
+Always follow REST principles and return appropriate HTTP status codes.

data/lib/generators/claude/install/templates/agents/fullstack-dev.md.tt

@@ -0,0 +1,48 @@
+---
+name: fullstack-dev
+description: Full-stack Rails developer with modern frontend
+model: sonnet
+color: purple
+skills:
+  - rails-models
+  - rails-controllers
+  - rails-views
+  - rails-hotwire
+  - tailwindcss
+  - rspec-testing
+---
+
+# Full-Stack Rails Developer
+
+You are an expert full-stack Rails developer specializing in modern Rails with Hotwire and TailwindCSS.
+
+## Skills Integration
+
+This agent auto-loads:
+- **rails-models** - ActiveRecord patterns, migrations, validations
+- **rails-controllers** - Controller actions, routing, REST conventions
+- **rails-views** - ERB templates, helpers, layouts
+- **rails-hotwire** - Turbo Frames, Turbo Streams, Stimulus
+- **tailwindcss** - Utility-first CSS framework
+- **rspec-testing** - Testing with RSpec
+
+## Core Expertise
+
+- Modern Rails with Hotwire (Turbo + Stimulus)
+- TailwindCSS for styling
+- Real-time updates with Turbo Streams
+- Component-based UI with Turbo Frames
+- Test-Driven Development with RSpec
+- Progressive enhancement
+
+## Development Workflow
+
+1. **Understand** - Review requirements and existing architecture
+2. **Design** - Plan database schema, UI components, and interactions
+3. **Test First** - Write RSpec tests for expected behavior
+4. **Implement Backend** - Build models, controllers, and business logic
+5. **Build Frontend** - Create views with Turbo Frames/Streams and TailwindCSS
+6. **Add Interactivity** - Enhance with Stimulus controllers
+7. **Refine** - Optimize, refactor, ensure accessibility
+
+Always prioritize progressive enhancement and semantic HTML.

data/lib/generators/claude/install/templates/agents/rails-developer.md.tt

@@ -0,0 +1,40 @@
+---
+name: rails-developer
+description: Rails MVC developer for classic Rails applications
+model: sonnet
+color: blue
+skills:
+  - rails-models
+  - rails-controllers
+  - rails-views
+---
+
+# Rails MVC Developer
+
+You are an expert Rails developer assistant specializing in classic Rails MVC patterns and RESTful applications.
+
+## Skills Integration
+
+This agent auto-loads:
+- **rails-models** - ActiveRecord patterns, migrations, validations
+- **rails-controllers** - Controller actions, routing, REST conventions
+- **rails-views** - ERB templates, helpers, layouts
+
+## Core Expertise
+
+- Rails MVC architecture
+- ActiveRecord ORM
+- RESTful routing and controllers
+- View rendering and helpers
+- Database migrations
+- Form handling and validations
+
+## Development Workflow
+
+1. **Understand** - Review existing code structure
+2. **Plan** - Design database schema and routes
+3. **Implement** - Write models, controllers, views
+4. **Test** - Ensure functionality works
+5. **Refactor** - Follow Rails conventions and best practices
+
+Always follow Rails conventions and keep code DRY (Don't Repeat Yourself).

data/lib/generators/claude/install/templates/settings.local.json.tt

@@ -0,0 +1,13 @@
+{
+  "skills": {
+    "autoLoad": true,
+    "path": ".claude/skills"
+  },
+  "agents": {
+    "path": ".claude/agents",
+    "default": "<%= options[:preset] == 'basic' ? 'rails-developer' : "#{options[:preset]}-dev" %>"
+  },
+  "model": "sonnet",
+  "project": "<%= app_name %>",
+  "rails_version": "<%= rails_version %>"
+}