ruby_llm-skills 0.2.0 → 0.4.0.pre1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 676c58cfd47ff3e3bbf9a8eeac47658c56f2537d189eef7f2743740b8c44afb8
-  data.tar.gz: b54d6857a8340b9aab46a37e6385296acd6190987ef816172f96b265a4378d72
+  metadata.gz: ebbccd1655baa8f141a020e2a32fdad03f8c6ddc7cd8929cb6b35cee8e4fc488
+  data.tar.gz: b1d175a5fc1ec6c7603318a42fdb34d44f25680da95fa21a2b3f042621644641
 SHA512:
-  metadata.gz: 22da0df8891691181c0db718da07e3b44ad1ca1cbd04d3991350e5f7fff9996390493a5f047833ff978b8798f447172cfc7f7ddbdffe1871054e61cea40709f0
-  data.tar.gz: 0a48577bdb85af0d6a1216857fbdb9e4389a2121f271bdc48cff4f35324be2854563b8934d62064667fd1b829959e3e595c05d8be7bd5475b7d6797a36cf992d
+  metadata.gz: 1b39b6966015406944f68897ed6170bce39cbd6f36ad6d363e650a1dbfc160a99a532e728b1e599d3b5243a4323db6c24220e79c20f796efa3c714a45126140d
+  data.tar.gz: eb71f38a6faa4c75faf675f9c6ce7ac7ae835db82a1a58c1d1c5c2b5ec5511426fc7c5e770ec91e1ad1019e8868c81a49ef65ae254e8cf4256e66f0348c87d41

data/CHANGELOG.md

@@ -5,6 +5,47 @@ 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).
 
+## [0.4.0.pre1] - 2026-09-10
+
+### Changed
+
+- **Breaking:** requires RubyLLM 2.0 (`ruby_llm >= 2.0.0.rc2, < 3`); 1.x users should stay on 0.3.x
+- `SkillTool` declares parameters with the 2.0 `parameter`/`description:` DSL, exposes `parameters_schema`, and sets its name through `tool_name`
+- `Chat#with_skills` registers the skill tool via `Chat#with_tools` (2.0 removed `Chat#with_tool`)
+- `AgentExtensions` hooks the 2.0 `Agent.apply_configuration(chat, input_values:, persist_instructions:)` signature and applies skills to the chat or `acts_as_chat` record it receives
+- Integration tests pin `openai_protocol = :chat_completions` and match VCR cassettes on method and URI so the recorded 1.x interactions replay under 2.0
+
+### Removed
+
+- Global `Module#delegate` fallback and its compatibility test (2.0's `Agent` uses `Forwardable`)
+- Dependency on the removed `Agent.llm_chat_for` hook
+
+### Fixed
+
+- StandardRB `Layout/EmptyLinesAroundModuleBody` offense in `chat_extensions.rb` that failed CI
+
+## [0.3.0] - 2026-02-17
+
+### Added
+
+- `RubyLLM::Agent` integration via `RubyLLM::Skills::AgentExtensions`
+- Class-level `skills` DSL on agent subclasses with source, `only:`, and proc support
+- Instance-level `with_skills` for runtime agent skill configuration
+- Agent-specific unit and integration test coverage
+- Compatibility tests for delegate fallback behavior
+
+### Changed
+
+- Tightened `ruby_llm` dependency from open lower bound to `~> 1.12`
+- Added explicit runtime compatibility checks for required `RubyLLM::Agent` hooks
+- Documented `agent.with_skills(...)` replacement semantics in README
+
+### Fixed
+
+- Dynamic skill blocks resolving to `nil` or `[]` no longer silently load default skills
+- Skill source normalization and validation now prevent nested/invalid source runtime crashes
+- Delegate fallback now supports common delegation options (`prefix`, `allow_nil`, `private`)
+
 ## [0.1.0] - 2025-01-15
 
 ### Added

data/README.md

@@ -9,9 +9,12 @@ Agent Skills for [RubyLLM](https://github.com/crmne/ruby_llm). Teach your AI how
 ## Installation
 
 ```ruby
-gem "ruby_llm-skills"
+gem "ruby_llm", "2.0.0.rc2"
+gem "ruby_llm-skills", "0.4.0.pre1"
 ```
 
+Requires RubyLLM 2.0 (`>= 2.0.0.rc2`). If you are still on RubyLLM 1.x, stay on `ruby_llm-skills ~> 0.3.0` and follow the [RubyLLM 2.0 upgrade guide](https://rubyllm.com/next/upgrading/) before upgrading both gems together.
+
 ## Quick Start
 
 ```ruby
@@ -31,6 +34,26 @@ chat.with_skills("app/skills", "app/commands") # multiple paths
 chat.with_skills("app/skills", user.skills)   # with database records
 ```
 
+### With RubyLLM::Agent
+
+```ruby
+class SupportAgent < RubyLLM::Agent
+  model "gpt-5-nano"
+  instructions "You are a support assistant."
+  skills "app/skills", only: [:faq, :troubleshooting]
+end
+
+chat = SupportAgent.chat
+chat.ask("How do I reset my password?")
+
+agent = SupportAgent.new
+agent.with_skills("extra/skills")
+agent.ask("What can you help with?")
+```
+
+`agent.with_skills(...)` replaces the current skill tool configuration.
+To combine sources, pass all sources in a single `skills`/`with_skills` call.
+
 ## Creating Skills
 
 ```
@@ -96,6 +119,37 @@ Default path auto-configured to `Rails.root/app/skills`.
 rails generate skill pdf-report --description "Generate PDF reports"
 ```
 
+## Development
+
+### Setup
+
+```bash
+bin/setup
+```
+
+### Running Tests
+
+```bash
+bundle exec rake test        # Unit tests (177 tests)
+bundle exec rake test_rails  # Rails integration tests (25+ tests)
+bundle exec rake test_all    # Both
+bundle exec rake             # Tests + linting
+```
+
+### Dummy Rails App
+
+A minimal Rails 8 app at `test/dummy/` tests Rails integration:
+
+- **Filesystem skills**: `app/skills/greeting/` tests directory-based loading
+- **Database skills**: `Skill` model tests ActiveRecord-based loading
+- **Generator tests**: Tests for `rails generate skill`
+- **Composite loading**: Tests combining filesystem + database sources
+
+```bash
+cd test/dummy
+bundle exec rails test  # Run Rails tests directly
+```
+
 ## Resources
 
 - [Agent Skills Specification](https://agentskills.io/specification)

data/lib/generators/skill/USAGE

@@ -0,0 +1,29 @@
+Description:
+    Creates a new Agent Skill following the agentskills.io specification.
+    Skills are stored in app/skills/ and contain a SKILL.md file with
+    YAML frontmatter (name, description) and markdown instructions.
+
+Example:
+    rails generate skill pdf-report --description "Generate PDF reports"
+
+    This creates:
+        app/skills/pdf-report/
+        app/skills/pdf-report/SKILL.md
+
+    With optional directories:
+        --scripts     Creates scripts/ directory for executable code
+        --references  Creates references/ directory for documentation
+        --assets      Creates assets/ directory for templates/images
+
+Full Example:
+    rails generate skill data-export -d "Export data to CSV/JSON. Use when asked to export or download data." --scripts --assets
+
+    This creates:
+        app/skills/data-export/
+        app/skills/data-export/SKILL.md
+        app/skills/data-export/scripts/.keep
+        app/skills/data-export/assets/.keep
+
+Note:
+    The description should include both what the skill does AND when to use it.
+    Example: "Generate PDF reports from data. Use when asked to create reports or export to PDF."

data/lib/generators/skill/skill_generator.rb

@@ -5,11 +5,16 @@ require "rails/generators"
 class SkillGenerator < Rails::Generators::NamedBase
   source_root File.expand_path("templates", __dir__)
 
-  class_option :description, type: :string, default: "Description of what this skill does"
-  class_option :license, type: :string, default: nil
-  class_option :scripts, type: :boolean, default: false
-  class_option :references, type: :boolean, default: false
-  class_option :assets, type: :boolean, default: false
+  class_option :description, type: :string, default: "Description of what this skill does. Use when...",
+    aliases: "-d", desc: "Short description of the skill (max 1024 chars)"
+  class_option :license, type: :string, default: nil,
+    aliases: "-l", desc: "License identifier (e.g., MIT, Apache-2.0)"
+  class_option :scripts, type: :boolean, default: false,
+    desc: "Create scripts/ directory for executable code"
+  class_option :references, type: :boolean, default: false,
+    desc: "Create references/ directory for documentation"
+  class_option :assets, type: :boolean, default: false,
+    desc: "Create assets/ directory for templates/images"
 
   def create_skill_directory
     empty_directory skill_path
@@ -57,4 +62,8 @@ class SkillGenerator < Rails::Generators::NamedBase
   def skill_license
     options[:license]
   end
+
+  def skill_title
+    skill_name.split("-").map(&:capitalize).join(" ")
+  end
 end

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

@@ -6,16 +6,52 @@ license: <%= skill_license %>
 <% end -%>
 ---
 
-# <%= skill_name.split("-").map(&:capitalize).join(" ") %>
+# <%= skill_title %>
 
-Instructions for using this skill.
+<%= skill_description %>
 
 ## When to Use
 
-Use this skill when...
+Use this skill when:
 
-## Steps
+- [Trigger condition 1 - be specific about keywords/phrases]
+- [Trigger condition 2]
 
-1. First step
-2. Second step
-3. Third step
+## Instructions
+
+### Step 1: [Action]
+
+[Clear instruction with expected outcome]
+
+### Step 2: [Action]
+
+[Clear instruction with expected outcome]
+
+### Step 3: [Action]
+
+[Clear instruction with expected outcome]
+
+## Examples
+
+### Example 1: [Scenario]
+
+**Input:**
+```
+[Example input or command]
+```
+
+**Output:**
+```
+[Expected result]
+```
+
+## Edge Cases
+
+- **[Scenario]**: [How to handle it]
+- **[Error condition]**: [Recovery steps]
+
+## Notes
+
+- Keep this file under 500 lines for optimal token usage
+- Move detailed documentation to `references/` directory
+- Move executable code to `scripts/` directory

data/lib/ruby_llm/skills/agent_extensions.rb

@@ -0,0 +1,149 @@
+# frozen_string_literal: true
+
+require_relative "source_detection"
+
+module RubyLLM
+  module Skills
+    # Extensions for RubyLLM::Agent to enable declarative skill configuration.
+    #
+    # @example Static skills
+    #   class SupportAgent < RubyLLM::Agent
+    #     skills "app/skills", only: [:faq]
+    #   end
+    #
+    # @example Dynamic skills
+    #   class WorkspaceAgent < RubyLLM::Agent
+    #     inputs :workspace
+    #     skills { [workspace.skill_collection] }
+    #   end
+    #
+    module AgentExtensions
+      REQUIRED_AGENT_SINGLETON_METHODS = %i[apply_configuration runtime_context].freeze
+
+      module ClassMethods
+        include SourceDetection
+
+        def self.extended(base)
+          base.instance_variable_set(:@skill_sources, nil)
+          base.instance_variable_set(:@skill_only, nil)
+        end
+
+        def inherited(subclass)
+          super
+          subclass.instance_variable_set(:@skill_sources, @skill_sources.is_a?(Proc) ? @skill_sources : @skill_sources&.dup)
+          subclass.instance_variable_set(:@skill_only, @skill_only&.dup)
+        end
+
+        # Declare skill sources for this agent class.
+        #
+        # Called with no arguments, returns the current configuration.
+        # Called with sources or a block, sets the configuration.
+        #
+        # @param sources [Array] skill sources
+        # @param only [Array<Symbol, String>, nil] include only these skills
+        # @return [Hash] current configuration when called as a getter
+        def skills(*sources, only: nil, &block)
+          if sources.empty? && only.nil? && !block_given?
+            return {
+              sources: @skill_sources.is_a?(Proc) ? @skill_sources : @skill_sources&.dup,
+              only: @skill_only&.dup
+            }
+          end
+
+          @skill_sources = block_given? ? block : normalize_skill_sources(sources)
+          @skill_only = only&.dup
+        end
+
+        private
+
+        def normalize_skill_sources(raw_sources)
+          flatten_skill_sources(raw_sources).compact
+        end
+
+        def flatten_skill_sources(source)
+          return [] if source.nil?
+          return [source] if source.is_a?(String)
+          return [source] if loader_source?(source)
+          return source.empty? ? [] : [source] if database_collection_source?(source)
+          return source.flat_map { |item| flatten_skill_sources(item) } if source.is_a?(Array)
+
+          [source]
+        end
+      end
+
+      module InstanceMethods
+        # Add skills to this agent instance at runtime.
+        #
+        # @param sources [Array] skill sources
+        # @param only [Array<Symbol, String>, nil] include only these skills
+        # @return [self] for chaining
+        def with_skills(*sources, only: nil)
+          chat.with_skills(*sources, only: only)
+          self
+        end
+      end
+
+      module ConfigurationPatch
+        # RubyLLM 2.0 passes either a RubyLLM::Chat or an acts_as_chat record.
+        # Both respond to #with_skills (ChatExtensions / ActiveRecordExtensions),
+        # so skills apply directly to whatever the agent configured.
+        #
+        # apply_configuration is a :nodoc: hook; **options forwards any keyword a
+        # later 2.x release adds so the patch fails at super, not before it.
+        def apply_configuration(chat, input_values: {}, **options)
+          super
+          runtime = runtime_context(chat: chat, inputs: input_values)
+          apply_skills(chat, runtime)
+        end
+
+        private
+
+        def apply_skills(chat, runtime)
+          config = skills
+          sources = config[:sources]
+          return if sources.nil?
+
+          resolved_sources = if sources.is_a?(Proc)
+            runtime.instance_exec(&sources)
+          else
+            sources
+          end
+
+          normalized_sources = normalize_skill_sources(resolved_sources)
+          return if normalized_sources.empty?
+
+          validate_skill_sources!(normalized_sources)
+          chat.with_skills(*normalized_sources, only: config[:only])
+        end
+
+        def validate_skill_sources!(sources)
+          invalid_sources = sources.reject { |source| valid_skill_source?(source) }
+          return if invalid_sources.empty?
+
+          invalid_types = invalid_sources.map { |source| source.class.name || source.class.to_s }.uniq.join(", ")
+          raise ArgumentError,
+            "Invalid skill source(s): #{invalid_types}. Expected String path, Loader, or record collection."
+        end
+
+        def valid_skill_source?(source)
+          source.is_a?(String) || loader_source?(source) || database_collection_source?(source)
+        end
+      end
+
+      def self.included(base)
+        missing_methods = REQUIRED_AGENT_SINGLETON_METHODS.reject do |method_name|
+          base.singleton_class.private_method_defined?(method_name) || base.singleton_class.method_defined?(method_name)
+        end
+
+        if missing_methods.any?
+          raise LoadError,
+            "RubyLLM::Agent is missing required methods for ruby_llm-skills integration: #{missing_methods.join(", ")}"
+        end
+
+        base.extend(ClassMethods)
+        base.include(InstanceMethods)
+        base.singleton_class.prepend(ConfigurationPatch)
+      end
+    end
+  end
+end

data/lib/ruby_llm/skills/chat_extensions.rb

@@ -1,8 +1,9 @@
 # frozen_string_literal: true
 
+require_relative "source_detection"
 require_relative "skill_tool"
 
-module RubyLlm
+module RubyLLM
   module Skills
     # Extensions for RubyLLM::Chat to enable skill integration.
     #
@@ -19,20 +20,22 @@ module RubyLlm
     #   chat.with_skills(only: [:pdf_report])
     #
     module ChatExtensions
+      include SourceDetection
+
       # Add skills to this chat.
       #
       # @param sources [Array] skill sources - auto-detects type (directory, zip, collection)
       # @param only [Array<Symbol, String>, nil] include only these skills
       # @return [self] for chaining
       def with_skills(*sources, only: nil)
-        sources = [RubyLlm::Skills.default_path] if sources.empty?
+        sources = [RubyLLM::Skills.default_path] if sources.empty?
         loaders = sources.map { |s| to_loader(s) }
 
-        loader = (loaders.length == 1) ? loaders.first : RubyLlm::Skills.compose(*loaders)
+        loader = (loaders.length == 1) ? loaders.first : RubyLLM::Skills.compose(*loaders)
         loader = FilteredLoader.new(loader, only) if only
 
-        skill_tool = RubyLlm::Skills::SkillTool.new(loader)
-        with_tool(skill_tool)
+        skill_tool = RubyLLM::Skills::SkillTool.new(loader)
+        with_tools(skill_tool)
       end
 
       private
@@ -40,11 +43,14 @@ module RubyLlm
       def to_loader(source)
         case source
         when String
-          RubyLlm::Skills.from_directory(source)
-        when ->(s) { s.respond_to?(:to_a) && s.first&.respond_to?(:name) && s.first.respond_to?(:content) }
-          RubyLlm::Skills.from_database(source)
-        else
+          RubyLLM::Skills.from_directory(source)
+        when ->(s) { database_collection_source?(s) }
+          RubyLLM::Skills.from_database(source)
+        when ->(s) { loader_source?(s) }
           source
+        else
+          raise ArgumentError,
+            "Invalid skill source: #{source.class}. Expected String path, Loader, or record collection."
         end
       end
     end

data/lib/ruby_llm/skills/composite_loader.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module RubyLlm
+module RubyLLM
   module Skills
     # Combines multiple loaders into a single source.
     #

data/lib/ruby_llm/skills/database_loader.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module RubyLlm
+module RubyLLM
   module Skills
     # Loads skills from database records.
     #

data/lib/ruby_llm/skills/error.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module RubyLlm
+module RubyLLM
   module Skills
     # Base error class for all skills-related errors.
     # Rescue this to catch any error from the gem.

data/lib/ruby_llm/skills/filesystem_loader.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module RubyLlm
+module RubyLLM
   module Skills
     # Loads skills from a filesystem directory.
     #

data/lib/ruby_llm/skills/loader.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module RubyLlm
+module RubyLLM
   module Skills
     # Base class for skill loaders.
     #

data/lib/ruby_llm/skills/parser.rb

@@ -2,7 +2,7 @@
 
 require "yaml"
 
-module RubyLlm
+module RubyLLM
   module Skills
     # Parses SKILL.md files with YAML frontmatter.
     #

data/lib/ruby_llm/skills/railtie.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module RubyLlm
+module RubyLLM
   module Skills
     # Rails integration for RubyLLM::Skills.
     #
@@ -9,14 +9,14 @@ module RubyLlm
     #
     class Railtie < ::Rails::Railtie
       initializer "ruby_llm_skills.configure" do
-        RubyLlm::Skills.default_path = Rails.root.join("app", "skills").to_s
+        RubyLLM::Skills.default_path = Rails.root.join("app", "skills").to_s
       end
 
-      # Add app/skills to autoload paths
-      initializer "ruby_llm_skills.autoload_paths" do |app|
+      # Add app/skills to autoload paths (before initialization)
+      config.before_configuration do |app|
         skills_path = Rails.root.join("app", "skills")
         if skills_path.exist?
-          app.config.autoload_paths << skills_path.to_s
+          app.config.autoload_paths += [skills_path.to_s]
         end
       end
 
@@ -24,7 +24,7 @@ module RubyLlm
       initializer "ruby_llm_skills.active_record" do
         ActiveSupport.on_load(:active_record) do
           if defined?(RubyLLM::ActiveRecord::ChatMethods)
-            RubyLLM::ActiveRecord::ChatMethods.include(RubyLlm::Skills::ActiveRecordExtensions)
+            RubyLLM::ActiveRecord::ChatMethods.include(RubyLLM::Skills::ActiveRecordExtensions)
           end
         end
       end

data/lib/ruby_llm/skills/skill.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module RubyLlm
+module RubyLLM
   module Skills
     # Represents a single skill with its metadata and content.
     #

data/lib/ruby_llm/skills/skill_tool.rb

@@ -2,7 +2,7 @@
 
 require "ruby_llm"
 
-module RubyLlm
+module RubyLLM
   module Skills
     # A RubyLLM Tool that enables progressive skill loading.
     #
@@ -17,8 +17,8 @@ module RubyLlm
     # 3. Resources (scripts, references) can be loaded separately as needed
     #
     # @example Basic usage
-    #   loader = RubyLlm::Skills.from_directory("app/skills")
-    #   skill_tool = RubyLlm::Skills::SkillTool.new(loader)
+    #   loader = RubyLLM::Skills.from_directory("app/skills")
+    #   skill_tool = RubyLLM::Skills::SkillTool.new(loader)
     #
     #   chat.with_tools(skill_tool)
     #   chat.ask("Help me generate a PDF report")
@@ -27,15 +27,22 @@ module RubyLlm
     #
     class SkillTool < RubyLLM::Tool
       description "Execute a skill within the main conversation."
-      param :command, type: "string",
-        desc: "The skill name (e.g., 'pdf' or 'write-poem')"
-      param :arguments, type: "string", required: false,
-        desc: "Arguments passed after the command (e.g., '/write-poem about robots' passes 'about robots')"
-      param :resource, type: "string", required: false,
-        desc: "Optional resource path to load (e.g., 'scripts/helper.rb', 'references/guide.md')"
+      parameter :command, type: "string",
+        description: "The skill name (e.g., 'pdf' or 'write-poem')"
+      parameter :arguments, type: "string", required: false,
+        description: "Arguments passed after the command (e.g., '/write-poem about robots' passes 'about robots')"
+      parameter :resource, type: "string", required: false,
+        description: "Optional resource path to load (e.g., 'scripts/helper.rb', 'references/guide.md')"
 
       attr_reader :loader
 
+      # Tool name for RubyLLM.
+      #
+      # @return [String] "skill"
+      def self.tool_name
+        "skill"
+      end
+
       # Initialize with a skill loader.
       #
       # @param loader [Loader] any loader (FilesystemLoader, ZipLoader, etc.)
@@ -43,13 +50,6 @@ module RubyLlm
         @loader = loader
       end
 
-      # Tool name for RubyLLM.
-      #
-      # @return [String] "skill"
-      def name
-        "skill"
-      end
-
       # Dynamic description including available skills.
       #
       # @return [String] tool description with embedded skill metadata
@@ -98,7 +98,7 @@ module RubyLlm
         {
           name: name,
           description: description,
-          parameters: params_schema
+          parameters: parameters_schema
         }
       end
 

data/lib/ruby_llm/skills/source_detection.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module RubyLLM
+  module Skills
+    # Shared duck-typing predicates for classifying skill sources.
+    # Used by both AgentExtensions and ChatExtensions.
+    module SourceDetection
+      private
+
+      def loader_source?(source)
+        source.respond_to?(:list) && source.respond_to?(:find)
+      end
+
+      def database_collection_source?(source)
+        return false unless source.respond_to?(:to_a)
+
+        # ActiveRecord relations/CollectionProxy: recognizable even when empty
+        return true if source.respond_to?(:klass) && source.respond_to?(:where_values_hash)
+
+        first = source.first
+        first&.respond_to?(:name) && first.respond_to?(:content)
+      end
+    end
+  end
+end

data/lib/ruby_llm/skills/validator.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module RubyLlm
+module RubyLLM
   module Skills
     # Validates skill structure according to the Agent Skills specification.
     #

data/lib/ruby_llm/skills/version.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-module RubyLlm
+module RubyLLM
   module Skills
-    VERSION = "0.2.0"
+    VERSION = "0.4.0.pre1"
   end
 end

data/lib/ruby_llm/skills.rb

@@ -10,14 +10,16 @@ require_relative "skills/skill"
 require_relative "skills/loader"
 require_relative "skills/filesystem_loader"
 require_relative "skills/chat_extensions"
+require_relative "skills/agent_extensions"
 
 # Load Rails integration when Rails is available
 require_relative "skills/railtie" if defined?(Rails::Railtie)
 
 # Extend RubyLLM::Chat with skill methods
-RubyLLM::Chat.include(RubyLlm::Skills::ChatExtensions)
+RubyLLM::Chat.include(RubyLLM::Skills::ChatExtensions)
+RubyLLM::Agent.include(RubyLLM::Skills::AgentExtensions)
 
-module RubyLlm
+module RubyLLM
   module Skills
     class << self
       attr_accessor :default_path
@@ -27,7 +29,7 @@ module RubyLlm
       # @param path [String] path to skills directory (defaults to default_path)
       # @return [FilesystemLoader] loader for the directory
       # @example
-      #   RubyLlm::Skills.from_directory("app/skills")
+      #   RubyLLM::Skills.from_directory("app/skills")
       def from_directory(path = default_path)
         FilesystemLoader.new(path)
       end
@@ -38,7 +40,7 @@ module RubyLlm
       # @return [Skill] the loaded skill
       # @raise [LoadError] if SKILL.md not found
       # @example
-      #   RubyLlm::Skills.load("app/skills/my-skill")
+      #   RubyLLM::Skills.load("app/skills/my-skill")
       def load(path)
         skill_md = File.join(path, "SKILL.md")
         raise LoadError, "SKILL.md not found in #{path}" unless File.exist?(skill_md)
@@ -52,7 +54,7 @@ module RubyLlm
       # @param records [ActiveRecord::Relation, Array] collection of skill records
       # @return [DatabaseLoader] loader for the records
       # @example
-      #   RubyLlm::Skills.from_database(Skill.where(active: true))
+      #   RubyLLM::Skills.from_database(Skill.where(active: true))
       def from_database(records)
         require_relative "skills/database_loader"
         DatabaseLoader.new(records)
@@ -63,9 +65,9 @@ module RubyLlm
       # @param loaders [Array<Loader>] loaders to combine
       # @return [CompositeLoader] combined loader
       # @example
-      #   RubyLlm::Skills.compose(
-      #     RubyLlm::Skills.from_directory("app/skills"),
-      #     RubyLlm::Skills.from_database(Skill.all)
+      #   RubyLLM::Skills.compose(
+      #     RubyLLM::Skills.from_directory("app/skills"),
+      #     RubyLLM::Skills.from_database(Skill.all)
       #   )
       def compose(*loaders)
         require_relative "skills/composite_loader"

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby_llm-skills
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0.pre1
 platform: ruby
 authors:
 - Kieran Klaassen
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-16 00:00:00.000000000 Z
+date: 2026-09-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby_llm
@@ -15,14 +16,20 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.10'
+        version: 2.0.0.rc2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.10'
+        version: 2.0.0.rc2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
 description: Load, validate, and integrate Agent Skills with RubyLLM. Supports the
   open Agent Skills specification for progressive skill discovery and loading from
   filesystem, zip archives, and databases.
@@ -35,9 +42,11 @@ files:
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
+- lib/generators/skill/USAGE
 - lib/generators/skill/skill_generator.rb
 - lib/generators/skill/templates/SKILL.md.tt
 - lib/ruby_llm/skills.rb
+- lib/ruby_llm/skills/agent_extensions.rb
 - lib/ruby_llm/skills/chat_extensions.rb
 - lib/ruby_llm/skills/composite_loader.rb
 - lib/ruby_llm/skills/database_loader.rb
@@ -48,6 +57,7 @@ files:
 - lib/ruby_llm/skills/railtie.rb
 - lib/ruby_llm/skills/skill.rb
 - lib/ruby_llm/skills/skill_tool.rb
+- lib/ruby_llm/skills/source_detection.rb
 - lib/ruby_llm/skills/tasks/skills.rake
 - lib/ruby_llm/skills/validator.rb
 - lib/ruby_llm/skills/version.rb
@@ -59,6 +69,7 @@ metadata:
   source_code_uri: https://github.com/kieranklaassen/ruby_llm-skills
   changelog_uri: https://github.com/kieranklaassen/ruby_llm-skills/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -69,11 +80,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.4.10
+signing_key:
 specification_version: 4
 summary: Agent Skills extension for RubyLLM
 test_files: []