rails_claude_skills 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6af4682c59ca62b92b3c29f0e46ee77b8ffd8f22ed345dce1508c04a0ea8026d
+  data.tar.gz: c1accd731a912d5a6ed1dd95362085428bec5c06791d806357cd9aead29e187c
+SHA512:
+  metadata.gz: 2c32dae628ca6fd51f125b6e15842bce34bc7d2257f583deb7a3540c05f514cabfb31de082054cdfd5e7d052329087ef17951b2b86083ed20d4c4ea6953782c2
+  data.tar.gz: abf938f972e596480a25b1df12a2ca556951e171dd7ee2bff92692ec17894fcce5d93e428b001ca81bab212836b3e1bd71368e9b6ad69c2e8f9b082f56ecad90

data/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,134 @@
+name: Bug Report
+description: Report a bug or unexpected behavior in Rails Claude Skills
+title: "[Bug]: "
+labels: ["bug", "needs-triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug! Please fill out this form as completely as possible.
+
+  - type: checkboxes
+    id: prerequisites
+    attributes:
+      label: Prerequisites
+      description: Before submitting, please verify the following
+      options:
+        - label: I have searched existing issues to make sure this bug hasn't been reported
+          required: true
+        - label: I am using a supported Ruby version (3.0+)
+          required: true
+        - label: I am using a supported Rails version (7.0+)
+          required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug Description
+      description: A clear and concise description of what the bug is
+      placeholder: When I run `rails g claude:install`, I get...
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to Reproduce
+      description: Step-by-step instructions to reproduce the issue
+      placeholder: |
+        1. Create new Rails app: `rails new myapp`
+        2. Add gem to Gemfile
+        3. Run `bundle install`
+        4. Run `rails g claude:install`
+        5. See error...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What did you expect to happen?
+      placeholder: The install generator should create a `.claude/` directory with skills
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What actually happened?
+      placeholder: |
+        Error message:
+        ```
+        undefined method `titleize' for nil:NilClass
+        ```
+    validations:
+      required: true
+
+  - type: input
+    id: gem-version
+    attributes:
+      label: Gem Version
+      description: Which version of rails_claude_skills are you using?
+      placeholder: "0.2.0"
+    validations:
+      required: true
+
+  - type: input
+    id: rails-version
+    attributes:
+      label: Rails Version
+      description: Which version of Rails are you using?
+      placeholder: "7.1.3"
+    validations:
+      required: true
+
+  - type: input
+    id: ruby-version
+    attributes:
+      label: Ruby Version
+      description: Which version of Ruby are you using?
+      placeholder: "3.3.0"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating System
+      description: Which operating system are you using?
+      options:
+        - macOS
+        - Linux
+        - Windows
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: code-snippets
+    attributes:
+      label: Relevant Code/Configuration
+      description: Please provide any relevant code snippets, configuration files, or logs
+      placeholder: |
+        ```ruby
+        # Paste relevant code here
+        ```
+      render: ruby
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Add any other context about the problem here (screenshots, error logs, etc.)
+      placeholder: Any additional information that might help us understand the issue
+
+  - type: checkboxes
+    id: contribution
+    attributes:
+      label: Would you like to submit a PR for this?
+      description: If you're interested in fixing this bug yourself, let us know!
+      options:
+        - label: I'd like to work on fixing this bug
+          required: false

data/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+blank_issues_enabled: false
+contact_links:
+  - name: 📚 Documentation
+    url: https://github.com/Shoebtamboli/rails_claude_skills/blob/main/README.md
+    about: Read the full documentation and usage guide
+  - name: 💬 GitHub Discussions
+    url: https://github.com/Shoebtamboli/rails_claude_skills/discussions
+    about: Ask questions and discuss ideas with the community
+  - name: 🚀 Contributing Guide
+    url: https://github.com/Shoebtamboli/rails_claude_skills/blob/main/CONTRIBUTING.md
+    about: Learn how to contribute to Rails Claude Skills

data/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,129 @@
+name: Feature Request
+description: Suggest a new feature or enhancement for Rails Claude Skills
+title: "[Feature]: "
+labels: ["enhancement", "needs-triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a new feature! We appreciate your ideas for improving Rails Claude Skills.
+
+  - type: checkboxes
+    id: prerequisites
+    attributes:
+      label: Prerequisites
+      description: Before submitting, please verify the following
+      options:
+        - label: I have searched existing issues and discussions to make sure this hasn't been suggested
+          required: true
+        - label: This feature would be useful to the wider Rails community, not just my specific use case
+          required: true
+
+  - type: dropdown
+    id: feature-type
+    attributes:
+      label: Feature Type
+      description: What type of feature are you suggesting?
+      options:
+        - New Skill (e.g., for a popular gem or Rails pattern)
+        - New Command (slash command for common workflows)
+        - New Rule (project guidelines or conventions)
+        - New Generator (entirely new generator type)
+        - Enhancement to Existing Feature
+        - Documentation Improvement
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem Statement
+      description: Is your feature request related to a problem? Please describe.
+      placeholder: I'm frustrated when I need to... OR It would be helpful if...
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: Describe the solution you'd like to see
+      placeholder: |
+        I would like to have a skill/command/rule that...
+
+        Example usage:
+        ```bash
+        rails g claude:skill devise-authentication
+        # or
+        /my-command argument
+        ```
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Describe any alternative solutions or features you've considered
+      placeholder: I considered using... but that doesn't work because...
+
+  - type: textarea
+    id: examples
+    attributes:
+      label: Examples from Other Tools
+      description: Are there similar features in other gems, tools, or frameworks?
+      placeholder: Similar to how gem X handles... or inspired by feature Y in...
+
+  - type: dropdown
+    id: preset
+    attributes:
+      label: Which Preset Should Include This?
+      description: If this is a new skill/command/rule, which preset(s) should include it by default?
+      multiple: true
+      options:
+        - Basic Preset
+        - Fullstack Preset
+        - API Preset
+        - None (users can add manually)
+        - Not Applicable
+
+  - type: textarea
+    id: use-cases
+    attributes:
+      label: Use Cases
+      description: Describe specific scenarios where this feature would be helpful
+      placeholder: |
+        1. When building a multi-tenant SaaS app...
+        2. When implementing authentication...
+        3. When deploying to production...
+    validations:
+      required: true
+
+  - type: textarea
+    id: benefits
+    attributes:
+      label: Benefits
+      description: How would this feature benefit Rails developers using Claude Code?
+      placeholder: |
+        - Saves time by...
+        - Reduces errors when...
+        - Improves code quality by...
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Add any other context, screenshots, code examples, or mockups about the feature
+      placeholder: Any additional information that would help us understand your request
+
+  - type: checkboxes
+    id: contribution
+    attributes:
+      label: Would you like to implement this feature?
+      description: If you're interested in contributing this feature yourself, let us know!
+      options:
+        - label: I'd like to implement this feature and submit a PR
+          required: false

data/.github/ISSUE_TEMPLATE/question.yml

@@ -0,0 +1,90 @@
+name: Question or Discussion
+description: Ask a question or start a discussion about Rails Claude Skills
+title: "[Question]: "
+labels: ["question"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Have a question about Rails Claude Skills? We're here to help!
+
+        **Note:** For bug reports, please use the "Bug Report" template instead.
+
+  - type: checkboxes
+    id: prerequisites
+    attributes:
+      label: Prerequisites
+      description: Before asking, please check the following
+      options:
+        - label: I have read the README and documentation
+          required: true
+        - label: I have searched existing issues and discussions
+          required: true
+
+  - type: dropdown
+    id: question-type
+    attributes:
+      label: Question Type
+      description: What type of question do you have?
+      options:
+        - How do I use a specific feature?
+        - How do I create custom content (skill/command/rule)?
+        - Best practices or recommendations
+        - Integration with other tools/gems
+        - General usage question
+        - Architecture or design question
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: question
+    attributes:
+      label: Your Question
+      description: What would you like to know?
+      placeholder: |
+        How do I...?
+        What's the best way to...?
+        Can Rails Claude Skills...?
+    validations:
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Context
+      description: Provide any relevant context about what you're trying to accomplish
+      placeholder: |
+        I'm working on a project where...
+        I'm trying to achieve...
+        I've already tried...
+
+  - type: textarea
+    id: attempted
+    attributes:
+      label: What Have You Tried?
+      description: What have you already attempted?
+      placeholder: |
+        I tried...
+        I looked at...
+        I read...
+
+  - type: input
+    id: gem-version
+    attributes:
+      label: Gem Version (if relevant)
+      description: Which version of rails_claude_skills are you using?
+      placeholder: "0.2.0"
+
+  - type: input
+    id: rails-version
+    attributes:
+      label: Rails Version (if relevant)
+      description: Which version of Rails are you using?
+      placeholder: "7.1.3"
+
+  - type: textarea
+    id: additional-info
+    attributes:
+      label: Additional Information
+      description: Any other details that might help us answer your question

data/.github/dependabot.yml

@@ -0,0 +1,19 @@
+version: 2
+updates:
+  # Maintain dependencies for Bundler
+  - package-ecosystem: "bundler"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+    groups:
+      rubocop:
+        patterns:
+          - "rubocop*"
+
+  # Maintain dependencies for GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5

data/.github/workflows/ci.yml

@@ -0,0 +1,77 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  lint:
+    name: RuboCop
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.2'
+          bundler-cache: true
+
+      - name: Run RuboCop
+        run: bundle exec rubocop
+
+  test:
+    name: Test (Ruby ${{ matrix.ruby }} / Rails ${{ matrix.rails }})
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ['3.0', '3.1', '3.2', '3.3']
+        rails: ['7.0', '7.1', '7.2']
+
+    env:
+      RAILS_VERSION: ${{ matrix.rails }}
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: false
+
+      - name: Install dependencies
+        run: |
+          gem install bundler
+          bundle install --jobs 4 --retry 3
+
+      - name: Run tests
+        run: bundle exec rspec
+
+  build:
+    name: Build Gem
+    runs-on: ubuntu-latest
+    needs: [lint, test]
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.2'
+          bundler-cache: true
+
+      - name: Build gem
+        run: bundle exec rake build
+
+      - name: Upload gem artifact
+        uses: actions/upload-artifact@v6
+        with:
+          name: rails_claude_skills-gem
+          path: pkg/*.gem
+          retention-days: 7

data/.github/workflows/release.yml

@@ -0,0 +1,66 @@
+name: Release
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to publish (e.g., 0.1.0)'
+        required: false
+
+permissions:
+  contents: read
+  packages: write
+
+jobs:
+  publish:
+    name: Build and Publish Gem
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.4'
+          bundler-cache: true
+
+      - name: Run tests
+        run: bundle exec rspec
+
+      - name: Build gem
+        run: gem build rails_claude_skills.gemspec
+
+      - name: Archive gem artifact
+        uses: actions/upload-artifact@v6
+        with:
+          name: rails_claude_skills-gem
+          path: "*.gem"
+          retention-days: 30
+
+      - name: Publish to RubyGems
+        if: github.event_name == 'release'
+        continue-on-error: true
+        env:
+          GEM_HOST_API_KEY: ${{ secrets.RUBYGEMS_API_KEY }}
+        run: |
+          mkdir -p ~/.gem
+          echo ":rubygems_api_key: ${GEM_HOST_API_KEY}" > ~/.gem/credentials
+          chmod 0600 ~/.gem/credentials
+          gem push rails_claude_skills-*.gem || echo "::warning::Failed to push to RubyGems"
+          rm -f ~/.gem/credentials
+
+      - name: Publish to GitHub Packages
+        if: github.event_name == 'release'
+        continue-on-error: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          OWNER: ${{ github.repository_owner }}
+        run: |
+          mkdir -p ~/.gem
+          echo ":github: Bearer ${GITHUB_TOKEN}" > ~/.gem/credentials
+          chmod 0600 ~/.gem/credentials
+          gem push --key github --host https://rubygems.pkg.github.com/${OWNER} rails_claude_skills-*.gem || echo "::warning::Failed to push to GitHub Packages"
+          rm -f ~/.gem/credentials

data/.rubocop.yml

@@ -0,0 +1,52 @@
+AllCops:
+  TargetRubyVersion: 3.0
+  NewCops: enable
+  SuggestExtensions: false
+  Exclude:
+    - 'bin/**/*'
+    - 'vendor/**/*'
+    - 'tmp/**/*'
+    - 'spec/fixtures/**/*'
+
+# Gem specific configuration
+Gemspec/RequireMFA:
+  Enabled: false
+
+Gemspec/DevelopmentDependencies:
+  Enabled: false
+
+# Style preferences
+Style/Documentation:
+  Enabled: false
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+
+# Layout preferences
+Layout/LineLength:
+  Max: 150
+
+# Metrics
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*'
+    - 'lib/generators/**/*'
+    - '*.gemspec'
+
+Metrics/MethodLength:
+  Max: 25
+  Exclude:
+    - 'lib/generators/**/*'
+
+Metrics/AbcSize:
+  Max: 25
+  Exclude:
+    - 'lib/generators/**/*'
+
+Metrics/ClassLength:
+  Max: 150
+  Exclude:
+    - 'lib/generators/**/*'

data/CHANGELOG.md

@@ -0,0 +1,94 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+For detailed release notes with auto-generated commit history, see [GitHub Releases](https://github.com/Shoebtamboli/rails_claude_skills/releases).
+
+## [Unreleased]
+
+No unreleased changes yet.
+
+## [0.1.0] - Unreleased
+
+### Initial Release (Preparing for Publication)
+
+A Rails generator gem that scaffolds Claude AI skills and agents for Rails projects, making AI-assisted development reusable and distributable.
+
+### Generators
+- **Install Generator** (`rails g claude:install`) - Initialize Claude skills with three presets (basic, fullstack, api)
+- **Skill Generator** (`rails g claude:skill`) - Create custom skills with templates (generic, model, controller, frontend)
+- **Agent Generator** (`rails g claude:agent`) - Create custom AI agents
+- **Command Generator** (`rails g claude:command`) - Create custom slash commands
+- **Rule Generator** (`rails g claude:rule`) - Create project-specific rules with templates (generic, testing, security, performance)
+- **Views Generator** (`rails g claude:views`) - Copy and customize gem resources (skills, commands, rules)
+
+### Pre-built Skills (18 total)
+**Core Rails:**
+- rails-models (ActiveRecord, migrations, validations, associations)
+- rails-controllers (routing, actions, REST conventions)
+- rails-views (ERB templates, helpers, partials)
+
+**Full-Stack Development:**
+- rails-hotwire (Turbo Drive, Frames, Streams, Stimulus)
+- tailwindcss (utility-first CSS)
+
+**Background Processing & Communication:**
+- rails-jobs (background jobs with Solid Queue)
+- rails-mailers (ActionMailer patterns)
+
+**Authentication & Authorization:**
+- rails-auth-with-devise (authentication with Devise, OmniAuth, API auth)
+- rails-authorization-cancancan (role-based access control)
+
+**API Development:**
+- rails-api-controllers (RESTful API patterns, versioning, authentication, rate limiting, CORS, pagination)
+
+**Testing:**
+- rspec-testing (RSpec patterns and best practices)
+- minitest-testing (Minitest patterns)
+
+**Utilities:**
+- rails-debugging (debugging tools and systematic process)
+- rails-pagination-kaminari (pagination patterns)
+- rails-deployment (deployment best practices)
+
+**Planning & Organization:**
+- plan-feature (feature planning workflow)
+- refine-requirements (requirements refinement)
+- create-task-files (task file creation)
+
+### Pre-built Commands (5 total)
+- quality (run linters and formatters)
+- turbo-feature (scaffold Hotwire Turbo features)
+- stimulus (create Stimulus controllers)
+- create-pr (create GitHub pull requests)
+- dbchange (database migration workflow)
+
+### Pre-built Rules (5 total)
+- code-style (coding standards)
+- testing (test requirements)
+- security (security guidelines)
+- database (database best practices)
+- hotwire (Hotwire conventions)
+
+### Pre-built Agents
+- rails-developer (Rails MVC development with models, controllers, views)
+- fullstack-dev (Modern full-stack with Hotwire, TailwindCSS, RSpec)
+- api-dev (API-focused development with authentication)
+
+### Features
+- Configuration system with settings.local.json
+- Support for Ruby 3.0+ and Rails 7.0+
+- Three installation presets (basic, fullstack, api)
+- Comprehensive documentation and examples
+- CI/CD with GitHub Actions
+
+### Documentation & Community
+- Comprehensive README with usage examples
+- CONTRIBUTING.md with detailed contribution guidelines
+- Issue templates (bug report, feature request, question)
+- Code of Conduct (Contributor Covenant 2.1)
+- CHANGELOG following Keep a Changelog format