ruby_llm-skills 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 676c58cfd47ff3e3bbf9a8eeac47658c56f2537d189eef7f2743740b8c44afb8
-  data.tar.gz: b54d6857a8340b9aab46a37e6385296acd6190987ef816172f96b265a4378d72
+  metadata.gz: '048ac6f6a76a7fd48994d208799b967754b25ecc3959acd56d44f5ab707f9f8d'
+  data.tar.gz: 268827da6d73359d9451b159b1abe68dea7881419df6b473cceeb2d8c74bc073
 SHA512:
-  metadata.gz: 22da0df8891691181c0db718da07e3b44ad1ca1cbd04d3991350e5f7fff9996390493a5f047833ff978b8798f447172cfc7f7ddbdffe1871054e61cea40709f0
-  data.tar.gz: 0a48577bdb85af0d6a1216857fbdb9e4389a2121f271bdc48cff4f35324be2854563b8934d62064667fd1b829959e3e595c05d8be7bd5475b7d6797a36cf992d
+  metadata.gz: febe501ab666f7e1cdf06e043ab44305ea065ffe561508b6fdcb9a959a90eabad8d2cb9fcc90384536eaf0871f73f2e52c3c9e93b8d883fbe8823274f547f0f3
+  data.tar.gz: 73226c3f1eb42ba6073dbfdcccb9f334896e078ca04ab1814260feb4218d432a83cf92817a32bb6c1abe847cf7fcd0098259aa2bab5886ce933d2c258d4ae8f1

data/CHANGELOG.md

@@ -5,6 +5,28 @@ 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.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

@@ -31,6 +31,26 @@ chat.with_skills("app/skills", "app/commands") # multiple paths
 chat.with_skills("app/skills", user.skills)   # with database records
 ```
 
+### With RubyLLM::Agent (v1.12+)
+
+```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 +116,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 (151 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,148 @@
+# frozen_string_literal: true
+
+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 llm_chat_for].freeze
+
+      module ClassMethods
+        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] if database_collection_source?(source)
+          return source.flat_map { |item| flatten_skill_sources(item) } if source.is_a?(Array)
+
+          [source]
+        end
+
+        def loader_source?(source)
+          source.respond_to?(:list) && source.respond_to?(:find)
+        end
+
+        def database_collection_source?(source)
+          source.respond_to?(:to_a) && source.first&.respond_to?(:name) && source.first.respond_to?(:content)
+        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
+        private
+
+        def apply_configuration(chat_object, **kwargs)
+          super
+          input_values = kwargs[:input_values] || {}
+          runtime = runtime_context(chat: chat_object, inputs: input_values)
+          apply_skills(llm_chat_for(chat_object), runtime)
+        end
+
+        def apply_skills(llm_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)
+          llm_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

@@ -2,7 +2,7 @@
 
 require_relative "skill_tool"
 
-module RubyLlm
+module RubyLLM
   module Skills
     # Extensions for RubyLLM::Chat to enable skill integration.
     #
@@ -25,13 +25,13 @@ module RubyLlm
       # @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)
+        skill_tool = RubyLLM::Skills::SkillTool.new(loader)
         with_tool(skill_tool)
       end
 
@@ -40,13 +40,24 @@ 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
+
+      def loader_source?(source)
+        source.respond_to?(:list) && source.respond_to?(:find)
+      end
+
+      def database_collection_source?(source)
+        source.respond_to?(:to_a) && source.first&.respond_to?(:name) && source.first.respond_to?(:content)
+      end
     end
 
     # Simple wrapper that filters skills by name.

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")

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.3.0"
   end
 end

data/lib/ruby_llm/skills.rb

@@ -1,5 +1,50 @@
 # frozen_string_literal: true
 
+# RubyLLM 1.12.0 Agent uses `delegate` but doesn't require ActiveSupport.
+# Provide a minimal fallback for plain Ruby environments.
+unless Module.method_defined?(:delegate)
+  class Module
+    def delegate(*methods, to:, prefix: nil, allow_nil: false, private: false, **_options)
+      target_method = to.to_sym
+
+      methods.each do |method_name|
+        delegated_method = delegated_method_name(method_name, target_method, prefix)
+
+        define_method(delegated_method) do |*args, **kwargs, &block|
+          target = public_send(target_method)
+          if target.nil?
+            return nil if allow_nil
+
+            raise NoMethodError,
+              "#{self.class}##{delegated_method} delegated to ##{target_method}, but ##{target_method} is nil"
+          end
+
+          if kwargs.empty?
+            target.public_send(method_name, *args, &block)
+          else
+            target.public_send(method_name, *args, **kwargs, &block)
+          end
+        end
+
+        private delegated_method if binding.local_variable_get(:private)
+      end
+    end
+
+    private
+
+    def delegated_method_name(method_name, target_method, prefix)
+      case prefix
+      when true
+        :"#{target_method}_#{method_name}"
+      when String, Symbol
+        :"#{prefix}_#{method_name}"
+      else
+        method_name
+      end
+    end
+  end
+end
+
 require "ruby_llm"
 
 require_relative "skills/version"
@@ -10,14 +55,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 +74,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 +85,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 +99,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 +110,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,28 +1,28 @@
 --- !ruby/object:Gem::Specification
 name: ruby_llm-skills
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Kieran Klaassen
 bindir: exe
 cert_chain: []
-date: 2026-01-16 00:00:00.000000000 Z
+date: 2026-02-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby_llm
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.10'
+        version: '1.12'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.10'
+        version: '1.12'
 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 +35,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