rails_skills 0.1.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 178573c6ee15fecc50390d962b0497fe63f76caa23a763105bb02cf2bd035742
-  data.tar.gz: 38fe007e723b016ea6ba499681baa7e76b2cdadbe59d8221697e60cd3719c31b
+  metadata.gz: 03c6340c54476e1461bcd09b5555135c7394feb027482313bfa70cc9b03c040c
+  data.tar.gz: dc0fed169889191177353cc7732dbb0a1585515a8c95bcbaca089f26c3fc4272
 SHA512:
-  metadata.gz: 58f7d7ea5fd40d5467f11182985ccecd43395f0a2e31aad41894d9a955088ef8c577e93568be38667a2a08e7f66f59bfea57995ad7fcb6a6993f90d7e3e46ad6
-  data.tar.gz: 1303af0ddab82bb8c0eae537997ca52b5ecf945bc1df025f23da37bf027d774826591249a0c7164bd61cdbe3ba088d23a454c17e7ce9036f430bd84ce1d9a97a
+  metadata.gz: 2ad4b1bc1c3d7849cfbbd784b2c913d9f8075ba41ad84108d0ddb3fa1c8e4b91da529112b1a54d1f99d92f8900292551c7acf0ef3c6ce8ea492028473caee9fe
+  data.tar.gz: 2aa688d5b29e489796708a42542a5aded29a46f9c58c1189aaf969942867342c4307f396d4408fa3132f3cc37c186d87f9ce5b5ee24335fa4ee5f7d089232532

data/README.md

@@ -20,31 +20,25 @@ bundle install
 
 ## Usage
 
-### Install with default (basic) preset
+### Install
 
 ```bash
 rails generate rails_skills:install
 ```
 
-### Install with a preset
-
-```bash
-rails generate rails_skills:install --preset=basic
-rails generate rails_skills:install --preset=fullstack
-rails generate rails_skills:install --preset=api
-```
-
 ### What it creates
 
 ```
 your_rails_app/
 ├── skills/                    # Shared AI skill files (canonical location)
-│   ├── rails-models/
-│   │   └── SKILL.md
-│   ├── rails-controllers/
-│   │   └── SKILL.md
-│   └── rails-views/
-│       └── SKILL.md
+│   ├── domains/               # Domain-specific skills
+│   │   └── .keep
+│   ├── stack/                 # Technology stack skills
+│   │   └── ruby/
+│   │       └── SKILL.md
+│   └── workflows/             # Workflow skills
+│       └── commit/
+│           └── SKILL.md
 ├── .claude/
 │   ├── skills -> ../skills    # Symlink to shared skills
 │   ├── agents/
@@ -57,35 +51,30 @@ your_rails_app/
 
 Both Claude and Codex read from the same `skills/` directory via symlinks.
 
-### Presets
+### Skill Categories
 
-| Preset | Skills included |
-|--------|----------------|
-| **basic** | rails-models, rails-controllers, rails-views |
-| **fullstack** | basic + rails-hotwire, rspec-testing |
-| **api** | rails-models, rails-api-controllers, rspec-testing |
+| Category | Purpose | Example |
+|----------|---------|---------|
+| **domains/** | Business domain knowledge | `domains/payments`, `domains/auth` |
+| **stack/** | Technology stack skills | `stack/ruby`, `stack/postgres` |
+| **workflows/** | Development workflows | `workflows/commit`, `workflows/deploy` |
 
 ### Create a custom skill
 
 ```bash
-rails generate rails_skills:skill my_custom_skill
-rails generate rails_skills:skill my_custom_skill --description="My skill description"
-rails generate rails_skills:skill my_custom_skill --with-references
+rails generate rails_skills:skill domains/payments
+rails generate rails_skills:skill stack/postgres
+rails generate rails_skills:skill workflows/deploy --description="Deployment workflow"
 ```
 
 Skills are created in `skills/` and automatically available to both Claude and Codex.
 
-## Skill Library
+## Default Skills
 
 The gem ships with these pre-built skills:
 
-- **rails-models** - ActiveRecord patterns, migrations, validations, associations
-- **rails-controllers** - Controller actions, routing, REST conventions, filters
-- **rails-views** - ERB templates, layouts, partials, forms, helpers
-- **rails-hotwire** - Turbo Drive, Turbo Frames, Turbo Streams, Stimulus
-- **rails-api-controllers** - API-only controllers, serialization, versioning
-- **rspec-testing** - RSpec patterns for models, requests, and system tests
-- **rails-jobs** - Active Job patterns, background processing
+- **stack/ruby** - Ruby language patterns, idioms, and best practices
+- **workflows/commit** - Git commit workflow and conventions
 
 ## How It Works
 

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

@@ -7,13 +7,14 @@ module RailsSkills
     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"
 
       def create_skills_directory
         empty_directory "skills"
+        empty_directory "skills/domains"
+        empty_directory "skills/stack"
+        empty_directory "skills/workflows"
       end
 
       def create_claude_directory
@@ -36,15 +37,25 @@ module RailsSkills
         template "settings.local.json.tt", ".claude/settings.local.json"
       end
 
-      def install_preset_skills
-        case options[:preset]
-        when "fullstack"
-          install_fullstack_preset
-        when "api"
-          install_api_preset
-        else
-          install_basic_preset
-        end
+      def install_default_skills
+        # domains - empty with .keep
+        install_skill_folder("domains")
+
+        # stack - ruby skill
+        install_skill("stack/ruby")
+
+        # workflows - commit skill
+        install_skill("workflows/commit")
+      end
+
+      def install_rules_and_commands
+        install_rule("code-style")
+        install_rule("testing")
+        install_command("quality")
+      end
+
+      def create_default_agent
+        template "agents/rails-developer.md.tt", ".claude/agents/rails-developer.md" unless options[:skip_agents]
       end
 
       def show_instructions
@@ -52,14 +63,19 @@ module RailsSkills
         say "RailsSkills installed successfully!", :green
         say ""
         say "Directory structure:", :yellow
-        say "  skills/           <- shared AI skill files (canonical location)"
-        say "  .claude/skills    -> ../skills (symlink)"
-        say "  .codex/skills     -> ../skills (symlink)"
+        say "  skills/"
+        say "    domains/       <- domain-specific skills"
+        say "    stack/         <- technology stack skills (ruby)"
+        say "    workflows/     <- workflow skills (commit)"
+        say "  .claude/skills   -> ../skills (symlink)"
+        say "  .codex/skills    -> ../skills (symlink)"
         say ""
-        say "Both Claude and Codex now share the same skills from skills/", :blue
+        say "Both Claude and Codex share skills from skills/", :blue
         say ""
         say "Next steps:", :yellow
-        say "  rails g rails_skills:skill my_skill   # Create a custom skill"
+        say "  rails g rails_skills:skill domains/my_domain   # Create a domain skill"
+        say "  rails g rails_skills:skill stack/postgres      # Create a stack skill"
+        say "  rails g rails_skills:skill workflows/deploy    # Create a workflow skill"
         say ""
       end
 
@@ -75,52 +91,22 @@ module RailsSkills
         end
       end
 
-      def install_basic_preset
-        say "Installing basic preset...", :green
-        install_skill("rails-models")
-        install_skill("rails-controllers")
-        install_skill("rails-views")
-        install_rule("code-style")
-        install_rule("testing")
-        install_command("quality")
-        create_basic_agent unless options[:skip_agents]
-      end
-
-      def install_fullstack_preset
-        say "Installing fullstack preset...", :green
-        install_skill("rails-models")
-        install_skill("rails-controllers")
-        install_skill("rails-views")
-        install_skill("rails-hotwire")
-        install_skill("rspec-testing")
-        install_rule("code-style")
-        install_rule("testing")
-        install_rule("security")
-        install_command("quality")
-        create_fullstack_agent unless options[:skip_agents]
-      end
-
-      def install_api_preset
-        say "Installing API preset...", :green
-        install_skill("rails-models")
-        install_skill("rails-api-controllers")
-        install_skill("rspec-testing")
-        install_rule("code-style")
-        install_rule("testing")
-        install_rule("security")
-        install_command("quality")
-        create_api_agent unless options[:skip_agents]
+      def install_skill_folder(folder_name)
+        skill_source = File.expand_path("../skills_library/#{folder_name}", __dir__)
+        if File.directory?(skill_source)
+          directory skill_source, "skills/#{folder_name}"
+        end
       end
 
-      def install_skill(skill_name)
-        skill_dir = "skills/#{skill_name}"
+      def install_skill(skill_path)
+        skill_dir = "skills/#{skill_path}"
         empty_directory skill_dir
 
-        skill_source = File.expand_path("../skills_library/#{skill_name}", __dir__)
+        skill_source = File.expand_path("../skills_library/#{skill_path}", __dir__)
         if File.directory?(skill_source)
           directory skill_source, skill_dir
         else
-          create_file "#{skill_dir}/SKILL.md", default_skill_content(skill_name)
+          create_file "#{skill_dir}/SKILL.md", default_skill_content(skill_path.split("/").last)
         end
       end
 
@@ -146,18 +132,6 @@ module RailsSkills
         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
           ---

data/lib/generators/rails_skills/skill/skill_generator.rb

@@ -28,7 +28,7 @@ module RailsSkills
       end
 
       def show_instructions
-        say "\nSkill '#{file_name}' created in #{skill_path}/", :green
+        say "\nSkill '#{skill_name}' created in #{skill_path}/", :green
         say "This skill is available to both Claude and Codex via symlinks.", :blue
       end
 
@@ -38,8 +38,12 @@ module RailsSkills
         "skills/#{file_name}"
       end
 
+      def skill_name
+        file_name.split("/").last
+      end
+
       def skill_description
-        options[:description] || "Custom skill for #{file_name.tr('-', ' ')}"
+        options[:description] || "Custom skill for #{skill_name.tr('-', ' ')}"
       end
     end
   end

data/lib/generators/rails_skills/skill/templates/SKILL.md.tt

@@ -1,10 +1,10 @@
 ---
-name: <%= file_name %>
+name: <%= skill_name %>
 description: <%= skill_description %>
 version: 1.0.0
 ---
 
-# <%= file_name.tr('-', ' ').split.map(&:capitalize).join(' ') %>
+# <%= skill_name.tr('-', ' ').split.map(&:capitalize).join(' ') %>
 
 ## Quick Reference
 

data/lib/generators/rails_skills/skills_library/stack/ruby/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: ruby
+description: Ruby language patterns, idioms, and best practices
+version: 1.0.0
+---
+
+# Ruby
+
+## Quick Reference
+
+| Pattern | Example |
+|---------|---------|
+| **Safe navigation** | `user&.name` |
+| **Dig** | `hash.dig(:user, :address, :city)` |
+| **Transform keys** | `hash.transform_keys(&:to_sym)` |
+| **Compact** | `array.compact` |
+| **Then/yield_self** | `value.then { \|v\| process(v) }` |
+
+## Idioms
+
+```ruby
+# Guard clauses
+def process(user)
+  return unless user
+  return if user.inactive?
+  # main logic
+end
+
+# Safe navigation
+user&.profile&.avatar_url
+
+# Hash with default
+counts = Hash.new(0)
+counts[:views] += 1
+
+# Destructuring
+first, *rest = array
+hash => { name:, email: }
+
+# Enumerable
+users.map(&:name)
+users.select(&:active?)
+users.find { |u| u.admin? }
+users.group_by(&:role)
+users.index_by(&:id)
+```
+
+## Collections
+
+```ruby
+# Map with index
+items.each_with_index { |item, i| }
+items.map.with_index { |item, i| }
+
+# Reduce
+numbers.reduce(0) { |sum, n| sum + n }
+numbers.sum
+
+# Partition
+active, inactive = users.partition(&:active?)
+
+# Zip
+names.zip(emails).map { |name, email| { name:, email: } }
+```
+
+## Blocks & Procs
+
+```ruby
+# Block to proc
+users.map(&:name)
+
+# Method reference
+users.map(&method(:process))
+
+# Proc/Lambda
+square = ->(x) { x * x }
+square.call(5)
+```
+
+## Best Practices
+
+1. Prefer guard clauses over nested conditionals
+2. Use `&.` safe navigation over `try` or conditionals
+3. Use symbols for hash keys
+4. Prefer `each` over `for`
+5. Use `freeze` for constants: `ROLES = %w[admin user].freeze`

data/lib/generators/rails_skills/skills_library/workflows/commit/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: commit
+description: Git commit workflow and conventions
+---
+
+# Workflow
+
+1. **Check status**: `git status`
+2. **Review changes**: `git diff`
+3. **Analyze missing docs/skills** - If you see changes to domains listed in skills/domains - review the need to update the skill doc
+3. **Stage files**: `git add <files>` (prefer specific files over `-A`)
+4. **Commit**: `git commit -m "type: message"`
+5. **Push**: Push only if explicitly asked so, use `git push origin {current branch}`
+
+# Commit Message Format
+
+```
+<type>: <subject>
+
+<body>
+
+<footer>
+```
+
+## Types
+
+- **feat**: New feature
+- **fix**: Bug fix
+- **docs**: Documentation only
+- **style**: Formatting, no code change
+- **refactor**: Code change that neither fixes nor adds
+- **test**: Adding or updating tests
+- **chore**: Maintenance tasks
+
+## Examples
+
+```
+feat: Add user authentication
+
+Implement login/logout functionality using Devise.
+Includes email/password authentication and session management.
+
+Closes #123
+```
+
+```
+fix: Prevent duplicate form submissions
+
+Add disable_with to submit buttons to prevent
+users from clicking multiple times.
+```

data/lib/rails_skills/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RailsSkills
-  VERSION = "0.1.0"
+  VERSION = "0.2.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rails_skills
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Sergii Mostovyi
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-28 00:00:00.000000000 Z
+date: 2026-01-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -38,22 +38,15 @@ files:
 - Rakefile
 - lib/generators/rails_skills/commands_library/quality.md
 - lib/generators/rails_skills/install/install_generator.rb
-- lib/generators/rails_skills/install/templates/agents/api-dev.md.tt
-- lib/generators/rails_skills/install/templates/agents/fullstack-dev.md.tt
 - lib/generators/rails_skills/install/templates/agents/rails-developer.md.tt
 - lib/generators/rails_skills/install/templates/settings.local.json.tt
 - lib/generators/rails_skills/rules_library/code-style.md
-- lib/generators/rails_skills/rules_library/security.md
 - lib/generators/rails_skills/rules_library/testing.md
 - lib/generators/rails_skills/skill/skill_generator.rb
 - lib/generators/rails_skills/skill/templates/SKILL.md.tt
-- lib/generators/rails_skills/skills_library/rails-api-controllers/SKILL.md
-- lib/generators/rails_skills/skills_library/rails-controllers/SKILL.md
-- lib/generators/rails_skills/skills_library/rails-hotwire/SKILL.md
-- lib/generators/rails_skills/skills_library/rails-jobs/SKILL.md
-- lib/generators/rails_skills/skills_library/rails-models/SKILL.md
-- lib/generators/rails_skills/skills_library/rails-views/SKILL.md
-- lib/generators/rails_skills/skills_library/rspec-testing/SKILL.md
+- lib/generators/rails_skills/skills_library/domains/.keep
+- lib/generators/rails_skills/skills_library/stack/ruby/SKILL.md
+- lib/generators/rails_skills/skills_library/workflows/commit/SKILL.md
 - lib/rails_skills.rb
 - lib/rails_skills/railtie.rb
 - lib/rails_skills/version.rb

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

@@ -1,28 +0,0 @@
-# API Developer Agent
-
-You are an API-focused Rails developer working on **<%= app_name %>** (Rails <%= rails_version %>).
-
-## Skills
-
-Load and follow all skills from the `skills/` directory, with emphasis on:
-- Rails models
-- API controllers
-- RSpec testing
-
-## Guidelines
-
-- Build RESTful JSON APIs
-- Use proper HTTP status codes
-- Implement authentication and authorization
-- Write comprehensive API tests
-- Document endpoints clearly
-- Follow JSON:API or similar conventions
-
-## Workflow
-
-1. Understand the API requirement
-2. Design the endpoint (HTTP method, path, request/response format)
-3. Start with the model and migrations
-4. Build the API controller
-5. Write request specs
-6. Document the endpoint

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

@@ -1,28 +0,0 @@
-# Fullstack Developer Agent
-
-You are a fullstack Rails developer working on **<%= app_name %>** (Rails <%= rails_version %>).
-
-## Skills
-
-Load and follow all skills from the `skills/` directory, with emphasis on:
-- Rails models, controllers, and views
-- Hotwire (Turbo + Stimulus)
-- RSpec testing
-
-## Guidelines
-
-- Follow Rails conventions and best practices
-- Build reactive UIs with Turbo Frames and Turbo Streams
-- Use Stimulus for JavaScript behavior
-- Write comprehensive RSpec tests
-- Use the project's existing patterns and style
-
-## Workflow
-
-1. Understand the requirement
-2. Plan the full-stack implementation (model, controller, views)
-3. Start with the model and migrations
-4. Build the controller with proper actions
-5. Create views with Hotwire integration
-6. Write RSpec tests for all layers
-7. Verify everything works end-to-end

data/lib/generators/rails_skills/rules_library/security.md

@@ -1,33 +0,0 @@
-# Security Rules
-
-## Input Handling
-
-- Always use strong parameters in controllers
-- Never trust user input - validate and sanitize
-- Use parameterized queries (ActiveRecord handles this by default)
-- Never interpolate user input into SQL strings
-
-## Authentication
-
-- Use established libraries (Devise, etc.) for authentication
-- Store passwords with bcrypt (`has_secure_password`)
-- Use CSRF protection (enabled by default in Rails)
-- Implement proper session management
-
-## Authorization
-
-- Check permissions in every controller action
-- Use authorization libraries (Pundit, CanCanCan) for complex rules
-- Never rely on hiding UI elements as a security measure
-
-## Output
-
-- ERB auto-escapes output by default - don't bypass with `raw` or `html_safe` unless necessary
-- Sanitize HTML content with `sanitize` helper
-- Set proper Content Security Policy headers
-
-## Secrets
-
-- Never commit secrets, API keys, or credentials to git
-- Use Rails credentials (`rails credentials:edit`) or environment variables
-- Add sensitive files to `.gitignore`

data/lib/generators/rails_skills/skills_library/rails-api-controllers/SKILL.md

@@ -1,106 +0,0 @@
----
-name: rails-api-controllers
-description: API-only controllers, serialization, authentication, versioning
-version: 1.0.0
----
-
-# Rails API Controllers
-
-## Quick Reference
-
-| Pattern | Example |
-|---------|---------|
-| **Base class** | `class Api::V1::PostsController < ActionController::API` |
-| **Render JSON** | `render json: @post, status: :ok` |
-| **Error response** | `render json: { error: "Not found" }, status: :not_found` |
-| **Pagination** | `@posts = Post.page(params[:page]).per(25)` |
-
-## API Controller Structure
-
-```ruby
-module Api
-  module V1
-    class PostsController < ApplicationController
-      def index
-        posts = Post.order(created_at: :desc).page(params[:page])
-        render json: posts
-      end
-
-      def show
-        post = Post.find(params[:id])
-        render json: post
-      end
-
-      def create
-        post = Post.new(post_params)
-
-        if post.save
-          render json: post, status: :created
-        else
-          render json: { errors: post.errors.full_messages }, status: :unprocessable_entity
-        end
-      end
-
-      def update
-        post = Post.find(params[:id])
-
-        if post.update(post_params)
-          render json: post
-        else
-          render json: { errors: post.errors.full_messages }, status: :unprocessable_entity
-        end
-      end
-
-      def destroy
-        post = Post.find(params[:id])
-        post.destroy
-        head :no_content
-      end
-
-      private
-
-      def post_params
-        params.require(:post).permit(:title, :body, :published)
-      end
-    end
-  end
-end
-```
-
-## API Routing
-
-```ruby
-Rails.application.routes.draw do
-  namespace :api do
-    namespace :v1 do
-      resources :posts
-      resources :users, only: [:index, :show]
-    end
-  end
-end
-```
-
-## Error Handling
-
-```ruby
-module Api
-  class ApplicationController < ActionController::API
-    rescue_from ActiveRecord::RecordNotFound do |e|
-      render json: { error: e.message }, status: :not_found
-    end
-
-    rescue_from ActionController::ParameterMissing do |e|
-      render json: { error: e.message }, status: :bad_request
-    end
-  end
-end
-```
-
-## Best Practices
-
-1. Use API-only base class (`ActionController::API`)
-2. Version your API with namespaces
-3. Return consistent error formats
-4. Use proper HTTP status codes
-5. Paginate list endpoints
-6. Use serializers for complex JSON responses

data/lib/generators/rails_skills/skills_library/rails-controllers/SKILL.md

@@ -1,125 +0,0 @@
----
-name: rails-controllers
-description: Controller actions, routing, REST conventions, filters, strong parameters
-version: 1.0.0
----
-
-# Rails Controllers
-
-## Quick Reference
-
-| Pattern | Example |
-|---------|---------|
-| **Generate** | `rails g controller Posts index show` |
-| **Route** | `resources :posts` |
-| **Filter** | `before_action :set_post, only: [:show, :edit, :update, :destroy]` |
-| **Strong params** | `params.require(:post).permit(:title, :body)` |
-| **Redirect** | `redirect_to @post, notice: "Created!"` |
-| **Render** | `render :new, status: :unprocessable_entity` |
-
-## Controller Structure
-
-```ruby
-class PostsController < ApplicationController
-  before_action :set_post, only: [:show, :edit, :update, :destroy]
-
-  def index
-    @posts = Post.all.order(created_at: :desc)
-  end
-
-  def show; end
-
-  def new
-    @post = Post.new
-  end
-
-  def create
-    @post = Post.new(post_params)
-
-    if @post.save
-      redirect_to @post, notice: "Post created."
-    else
-      render :new, status: :unprocessable_entity
-    end
-  end
-
-  def edit; end
-
-  def update
-    if @post.update(post_params)
-      redirect_to @post, notice: "Post updated."
-    else
-      render :edit, status: :unprocessable_entity
-    end
-  end
-
-  def destroy
-    @post.destroy
-    redirect_to posts_path, notice: "Post deleted."
-  end
-
-  private
-
-  def set_post
-    @post = Post.find(params[:id])
-  end
-
-  def post_params
-    params.require(:post).permit(:title, :body, :published)
-  end
-end
-```
-
-## Routing
-
-```ruby
-Rails.application.routes.draw do
-  resources :posts
-  resources :posts, only: [:index, :show]
-
-  resources :authors do
-    resources :posts, shallow: true
-  end
-
-  resources :posts do
-    member { post :publish }
-    collection { get :archived }
-  end
-
-  namespace :admin do
-    resources :users
-  end
-end
-```
-
-## Response Formats
-
-```ruby
-respond_to do |format|
-  format.html { redirect_to @post }
-  format.json { render json: @post, status: :created }
-  format.turbo_stream
-end
-```
-
-## Error Handling
-
-```ruby
-class ApplicationController < ActionController::Base
-  rescue_from ActiveRecord::RecordNotFound, with: :not_found
-
-  private
-
-  def not_found
-    render file: Rails.root.join("public/404.html"), status: :not_found
-  end
-end
-```
-
-## Best Practices
-
-1. Keep controllers thin - move logic to models or service objects
-2. Always use strong parameters
-3. Use `before_action` for shared setup
-4. Return proper HTTP status codes
-5. Follow RESTful conventions

data/lib/generators/rails_skills/skills_library/rails-hotwire/SKILL.md

@@ -1,89 +0,0 @@
----
-name: rails-hotwire
-description: Turbo Drive, Turbo Frames, Turbo Streams, and Stimulus
-version: 1.0.0
----
-
-# Rails Hotwire
-
-## Quick Reference
-
-| Pattern | Example |
-|---------|---------|
-| **Turbo Frame** | `<%= turbo_frame_tag "name" do %>` |
-| **Turbo Stream** | `<%= turbo_stream.append "list" do %>` |
-| **Stimulus controller** | `data-controller="toggle"` |
-| **Stimulus action** | `data-action="click->toggle#switch"` |
-| **Stimulus target** | `data-toggle-target="content"` |
-
-## Turbo Frames
-
-```erb
-<%# Wrap content in a frame %>
-<%= turbo_frame_tag "post_#{@post.id}" do %>
-  <h2><%= @post.title %></h2>
-  <%= link_to "Edit", edit_post_path(@post) %>
-<% end %>
-
-<%# Lazy-loaded frame %>
-<%= turbo_frame_tag "comments", src: post_comments_path(@post), loading: :lazy do %>
-  <p>Loading comments...</p>
-<% end %>
-```
-
-## Turbo Streams
-
-```erb
-<%# app/views/posts/create.turbo_stream.erb %>
-<%= turbo_stream.prepend "posts" do %>
-  <%= render @post %>
-<% end %>
-
-<%= turbo_stream.update "flash" do %>
-  <div class="notice">Post created!</div>
-<% end %>
-
-<%# Actions: append, prepend, replace, update, remove, before, after %>
-```
-
-### Broadcasts from Model
-
-```ruby
-class Post < ApplicationRecord
-  after_create_commit { broadcast_prepend_to "posts" }
-  after_update_commit { broadcast_replace_to "posts" }
-  after_destroy_commit { broadcast_remove_to "posts" }
-end
-```
-
-## Stimulus
-
-```javascript
-// app/javascript/controllers/toggle_controller.js
-import { Controller } from "@hotwired/stimulus"
-
-export default class extends Controller {
-  static targets = ["content"]
-
-  toggle() {
-    this.contentTarget.classList.toggle("hidden")
-  }
-}
-```
-
-```erb
-<div data-controller="toggle">
-  <button data-action="click->toggle#toggle">Toggle</button>
-  <div data-toggle-target="content">
-    Content here
-  </div>
-</div>
-```
-
-## Best Practices
-
-1. Start with Turbo Drive (enabled by default)
-2. Use Turbo Frames for in-page updates
-3. Use Turbo Streams for multi-element updates
-4. Use Stimulus only when HTML-over-the-wire isn't enough
-5. Keep Stimulus controllers small and focused

data/lib/generators/rails_skills/skills_library/rails-jobs/SKILL.md

@@ -1,39 +0,0 @@
----
-name: rails-jobs
-description: Active Job patterns, Sidekiq, background processing
-version: 1.0.0
----
-
-# Rails Background Jobs
-
-## Quick Reference
-
-| Pattern | Example |
-|---------|---------|
-| **Generate** | `rails g job ProcessOrder` |
-| **Enqueue** | `ProcessOrderJob.perform_later(order)` |
-| **Enqueue later** | `ProcessOrderJob.set(wait: 5.minutes).perform_later(order)` |
-| **Enqueue at** | `ProcessOrderJob.set(wait_until: Date.tomorrow.noon).perform_later(order)` |
-
-## Job Structure
-
-```ruby
-class ProcessOrderJob < ApplicationJob
-  queue_as :default
-  retry_on ActiveRecord::Deadlocked, wait: 5.seconds, attempts: 3
-  discard_on ActiveJob::DeserializationError
-
-  def perform(order)
-    order.process!
-    OrderMailer.confirmation(order).deliver_later
-  end
-end
-```
-
-## Best Practices
-
-1. Keep jobs idempotent
-2. Pass IDs instead of full objects when possible
-3. Use appropriate queues for different priorities
-4. Handle retries and failures gracefully
-5. Monitor queue depths in production

data/lib/generators/rails_skills/skills_library/rails-models/SKILL.md

@@ -1,105 +0,0 @@
----
-name: rails-models
-description: ActiveRecord patterns, migrations, validations, callbacks, associations
-version: 1.0.0
----
-
-# Rails Models (ActiveRecord)
-
-## Quick Reference
-
-| Pattern | Example |
-|---------|---------|
-| **Generate model** | `rails g model User name:string email:string` |
-| **Migration** | `rails g migration AddAgeToUsers age:integer` |
-| **Validation** | `validates :email, presence: true, uniqueness: true` |
-| **Association** | `has_many :posts, dependent: :destroy` |
-| **Scope** | `scope :active, -> { where(active: true) }` |
-
-## Model Structure
-
-```ruby
-class User < ApplicationRecord
-  # Constants
-  ROLES = %w[admin editor viewer].freeze
-
-  # Associations
-  has_many :posts, dependent: :destroy
-  belongs_to :organization, optional: true
-
-  # Validations
-  validates :email, presence: true, uniqueness: { case_sensitive: false }
-  validates :name, presence: true, length: { minimum: 2, maximum: 100 }
-  validates :role, inclusion: { in: ROLES }
-
-  # Callbacks
-  before_save :normalize_email
-
-  # Scopes
-  scope :active, -> { where(active: true) }
-  scope :recent, -> { order(created_at: :desc) }
-
-  # Enums
-  enum :status, { pending: 0, active: 1, archived: 2 }
-
-  private
-
-  def normalize_email
-    self.email = email.downcase.strip
-  end
-end
-```
-
-## Migrations
-
-```ruby
-class CreateUsers < ActiveRecord::Migration[7.0]
-  def change
-    create_table :users do |t|
-      t.string :name, null: false
-      t.string :email, null: false
-      t.boolean :active, default: true
-      t.references :organization, foreign_key: true
-      t.timestamps
-    end
-
-    add_index :users, :email, unique: true
-  end
-end
-```
-
-## Associations
-
-- `has_many :items, dependent: :destroy`
-- `belongs_to :parent, optional: true`
-- `has_many :tags, through: :taggings`
-- `has_one :profile, dependent: :destroy`
-- `has_many :comments, as: :commentable` (polymorphic)
-
-## Validations
-
-- `validates :field, presence: true`
-- `validates :email, uniqueness: { case_sensitive: false }`
-- `validates :age, numericality: { greater_than: 0 }`
-- `validates :field, length: { minimum: 2, maximum: 100 }`
-- `validates :field, format: { with: /\Apattern\z/ }`
-- `validate :custom_validation_method`
-
-## Queries
-
-```ruby
-User.where(active: true)
-User.where.not(role: "guest")
-User.joins(:posts).where(posts: { published: true })
-User.includes(:posts).order(created_at: :desc)
-User.pluck(:id, :name)
-User.group(:role).count
-```
-
-## Best Practices
-
-1. Add database-level constraints (NOT NULL, unique indexes, foreign keys)
-2. Use `includes` to avoid N+1 queries
-3. Keep callbacks simple, use service objects for complex logic
-4. Use scopes for reusable query fragments
-5. Use concerns to share behavior across models

data/lib/generators/rails_skills/skills_library/rails-views/SKILL.md

@@ -1,109 +0,0 @@
----
-name: rails-views
-description: ERB templates, layouts, partials, forms, and view helpers
-version: 1.0.0
----
-
-# Rails Views
-
-## Quick Reference
-
-| Pattern | Example |
-|---------|---------|
-| **Output** | `<%= @post.title %>` |
-| **Logic** | `<% if condition %>` |
-| **Partial** | `<%= render "shared/header" %>` |
-| **Collection** | `<%= render @posts %>` |
-| **Form** | `<%= form_with model: @post do \|f\| %>` |
-| **Link** | `<%= link_to "Home", root_path %>` |
-
-## Layouts
-
-```erb
-<!DOCTYPE html>
-<html>
-  <head>
-    <title><%= content_for?(:title) ? yield(:title) : "App" %></title>
-    <%= csrf_meta_tags %>
-    <%= stylesheet_link_tag "application" %>
-    <%= javascript_importmap_tags %>
-  </head>
-  <body>
-    <% flash.each do |type, message| %>
-      <div class="flash flash-<%= type %>"><%= message %></div>
-    <% end %>
-    <%= yield %>
-  </body>
-</html>
-```
-
-## Partials
-
-```erb
-<%# Render a partial %>
-<%= render "post", post: @post %>
-
-<%# Render a collection %>
-<%= render partial: "post", collection: @posts %>
-
-<%# Shorthand for collection %>
-<%= render @posts %>
-```
-
-## Forms
-
-```erb
-<%= form_with model: @post do |f| %>
-  <div>
-    <%= f.label :title %>
-    <%= f.text_field :title %>
-  </div>
-
-  <div>
-    <%= f.label :body %>
-    <%= f.text_area :body %>
-  </div>
-
-  <div>
-    <%= f.label :category_id %>
-    <%= f.collection_select :category_id, Category.all, :id, :name, prompt: "Select" %>
-  </div>
-
-  <%= f.submit %>
-<% end %>
-```
-
-## Helpers
-
-```ruby
-module ApplicationHelper
-  def page_title(title)
-    content_for(:title) { title }
-    content_tag(:h1, title)
-  end
-
-  def active_class(path)
-    current_page?(path) ? "active" : ""
-  end
-end
-```
-
-## Turbo Frames
-
-```erb
-<%= turbo_frame_tag "post_#{@post.id}" do %>
-  <%= render @post %>
-<% end %>
-
-<%= turbo_frame_tag "post", src: post_path(@post), loading: :lazy do %>
-  Loading...
-<% end %>
-```
-
-## Best Practices
-
-1. Keep logic out of views - use helpers or presenters
-2. Use partials for reusable components
-3. Always escape user input (ERB does this by default)
-4. Use `content_for` for flexible layouts
-5. Use Turbo Frames for partial page updates

data/lib/generators/rails_skills/skills_library/rspec-testing/SKILL.md

@@ -1,105 +0,0 @@
----
-name: rspec-testing
-description: RSpec testing patterns for models, controllers, requests, and system tests
-version: 1.0.0
----
-
-# RSpec Testing
-
-## Quick Reference
-
-| Pattern | Example |
-|---------|---------|
-| **Run all** | `bundle exec rspec` |
-| **Run file** | `bundle exec rspec spec/models/user_spec.rb` |
-| **Run line** | `bundle exec rspec spec/models/user_spec.rb:15` |
-| **Run tag** | `bundle exec rspec --tag focus` |
-
-## Model Specs
-
-```ruby
-RSpec.describe User, type: :model do
-  describe "validations" do
-    it { is_expected.to validate_presence_of(:email) }
-    it { is_expected.to validate_uniqueness_of(:email).case_insensitive }
-  end
-
-  describe "associations" do
-    it { is_expected.to have_many(:posts).dependent(:destroy) }
-    it { is_expected.to belong_to(:organization).optional }
-  end
-
-  describe "#full_name" do
-    it "returns first and last name" do
-      user = build(:user, first_name: "Jane", last_name: "Doe")
-      expect(user.full_name).to eq("Jane Doe")
-    end
-  end
-end
-```
-
-## Request Specs
-
-```ruby
-RSpec.describe "Posts", type: :request do
-  describe "GET /posts" do
-    it "returns a successful response" do
-      get posts_path
-      expect(response).to have_http_status(:ok)
-    end
-  end
-
-  describe "POST /posts" do
-    let(:valid_params) { { post: { title: "Test", body: "Content" } } }
-
-    it "creates a post" do
-      expect {
-        post posts_path, params: valid_params
-      }.to change(Post, :count).by(1)
-    end
-  end
-end
-```
-
-## System Specs
-
-```ruby
-RSpec.describe "Managing posts", type: :system do
-  before { driven_by(:rack_test) }
-
-  it "allows creating a new post" do
-    visit new_post_path
-    fill_in "Title", with: "My Post"
-    fill_in "Body", with: "Content"
-    click_on "Create Post"
-
-    expect(page).to have_content("Post created")
-    expect(page).to have_content("My Post")
-  end
-end
-```
-
-## Factories (FactoryBot)
-
-```ruby
-FactoryBot.define do
-  factory :user do
-    name { "John Doe" }
-    email { Faker::Internet.email }
-    role { "viewer" }
-
-    trait :admin do
-      role { "admin" }
-    end
-  end
-end
-```
-
-## Best Practices
-
-1. Test behavior, not implementation
-2. Use `let` and `before` for setup, keep `it` blocks focused
-3. Use factories instead of fixtures
-4. Write request specs over controller specs
-5. Use `have_http_status` for response assertions
-6. Keep specs fast - minimize database interactions