ruby_llm-skills 0.3.0 → 0.5.0.pre1

data/lib/ruby_llm/skills/source_detection.rb

@@ -0,0 +1,30 @@
+# 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
+
+      # A Marketplace::Registry: its installed plugins load through #loader.
+      def marketplace_source?(source)
+        source.respond_to?(:installed) && source.respond_to?(:loader)
+      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/tasks/marketplaces.rake

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+# Plugin marketplaces from the command line:
+#
+#   rake skills:marketplaces:add[EveryInc/compound-writing]        # record a marketplace
+#   rake skills:marketplaces:add[typesafe-ai/skills,v0.5.7]        # pinned to a tag or commit
+#   rake skills:marketplaces:list                                  # what is recorded and installed
+#   rake skills:marketplaces:plugins[compound-writing]             # the plugins a marketplace lists
+#   rake skills:marketplaces:install[compound-writing]             # every supported plugin
+#   rake skills:marketplaces:install[compound-writing,cw-draft]    # selected plugins (space separated)
+#   rake skills:marketplaces:install                               # reproduce the lockfile
+#   rake skills:marketplaces:update                                # move unpinned marketplaces forward
+#   rake skills:marketplaces:remove[compound-writing]
+#
+# Under Rails the tasks load the environment first, so the root and lockfile
+# resolve against Rails.root.
+namespace :skills do
+  namespace :marketplaces do
+    prerequisites = Rake::Task.task_defined?(:environment) ? [:environment] : []
+
+    registry = -> { RubyLLM::Skills.marketplaces }
+
+    report = lambda do |result|
+      result.installed.each { |key| puts "  + #{key}" }
+      result.updated.each { |key| puts "  ~ #{key}" }
+      result.unchanged.each { |key| puts "  = #{key}" }
+      result.skipped.each { |key, reason| puts "  - #{key}: #{reason}" }
+      result.errors.each { |key, message| puts "  ! #{key}: #{message}" }
+      abort("#{result.errors.size} plugin(s) failed") unless result.success?
+    end
+
+    desc "Add a marketplace (owner/repo, owner/repo@ref, repository URL, hosted marketplace.json URL, or directory)"
+    task :add, [:locator, :ref] => prerequisites do |_, args|
+      abort("Usage: rake skills:marketplaces:add[locator,ref]") unless args[:locator]
+
+      record = registry.call.add(args[:locator], ref: args[:ref])
+      puts "Added #{record.name} from #{record.source} at #{record.commit[0, 12]}"
+      puts "Install with: rake skills:marketplaces:install[#{record.name}]"
+    end
+
+    desc "List the recorded marketplaces and their installed plugins"
+    task list: prerequisites do
+      records = registry.call.list
+      if records.empty?
+        puts "No marketplaces in #{registry.call.lockfile_path}"
+        next
+      end
+
+      records.each do |record|
+        pin = record.pinned? ? " (pinned)" : ""
+        puts "#{record.name}  #{record.source}  @#{record.commit.to_s[0, 12]}#{pin}"
+        record.plugins.each_value do |plugin|
+          puts "  #{plugin.name} #{plugin.version}  skills: #{plugin.skills.join(", ")}"
+        end
+      end
+    end
+
+    desc "List the plugins a marketplace offers"
+    task :plugins, [:name] => prerequisites do |_, args|
+      abort("Usage: rake skills:marketplaces:plugins[marketplace]") unless args[:name]
+
+      record = registry.call.fetch(args[:name])
+      registry.call.plugins(record.name).each do |entry|
+        state = if record.plugins.key?(entry.name)
+          "installed"
+        elsif entry.supported?
+          "available"
+        else
+          "unsupported (#{entry.source.reason})"
+        end
+        puts "#{entry.name}  #{entry.version || "-"}  #{state}"
+        puts "  #{entry.description}" if entry.description
+      end
+    end
+
+    desc "Install a marketplace's plugins (all, or the space separated names), or reproduce the lockfile"
+    task :install, [:name, :plugins] => prerequisites do |_, args|
+      only = args[:plugins]&.split
+      report.call(registry.call.install(args[:name], only: only))
+    end
+
+    desc "Update every marketplace (or one) to its ref's current head"
+    task :update, [:name] => prerequisites do |_, args|
+      report.call(registry.call.update(args[:name]))
+    end
+
+    desc "Remove a marketplace and its installed plugins"
+    task :remove, [:name] => prerequisites do |_, args|
+      abort("Usage: rake skills:marketplaces:remove[marketplace]") unless args[:name]
+
+      record = registry.call.remove(args[:name])
+      puts "Removed #{record.name}"
+    end
+  end
+end

data/lib/ruby_llm/skills/tasks.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+# Loads the gem's Rake tasks outside Rails (the Railtie loads them under Rails):
+#
+#   # Rakefile
+#   require "ruby_llm/skills/tasks"
+#
+require "ruby_llm/skills"
+
+load File.expand_path("tasks/skills.rake", __dir__)
+load File.expand_path("tasks/marketplaces.rake", __dir__)

data/lib/ruby_llm/skills/version.rb

@@ -2,6 +2,6 @@
 
 module RubyLLM
   module Skills
-    VERSION = "0.3.0"
+    VERSION = "0.5.0.pre1"
   end
 end

data/lib/ruby_llm/skills.rb

@@ -1,50 +1,5 @@
 # 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"
@@ -56,6 +11,7 @@ require_relative "skills/loader"
 require_relative "skills/filesystem_loader"
 require_relative "skills/chat_extensions"
 require_relative "skills/agent_extensions"
+require_relative "skills/marketplace"
 
 # Load Rails integration when Rails is available
 require_relative "skills/railtie" if defined?(Rails::Railtie)
@@ -118,6 +74,28 @@ module RubyLLM
         require_relative "skills/composite_loader"
         CompositeLoader.new(loaders)
       end
+
+      # The plugin marketplaces recorded in a lockfile and installed under a root.
+      #
+      # @param root [String] where plugins are installed (default: vendor/skills)
+      # @param lockfile [String] the lockfile (default: skills.lock.json)
+      # @return [Marketplace::Registry]
+      # @example
+      #   marketplaces = RubyLLM::Skills.marketplaces
+      #   marketplaces.add("EveryInc/compound-writing")
+      #   marketplaces.install("compound-writing")
+      def marketplaces(root: Marketplace.root, lockfile: Marketplace.lockfile)
+        Marketplace::Registry.new(root: root, lockfile: lockfile)
+      end
+
+      # Load the skills of every installed marketplace plugin.
+      #
+      # @return [Loader] loader over the installed plugins' skills
+      # @example
+      #   chat.with_skills("app/skills", RubyLLM::Skills.from_marketplaces)
+      def from_marketplaces(root: Marketplace.root, lockfile: Marketplace.lockfile)
+        marketplaces(root: root, lockfile: lockfile).loader
+      end
     end
 
     self.default_path = "app/skills"

metadata

@@ -1,28 +1,35 @@
 --- !ruby/object:Gem::Specification
 name: ruby_llm-skills
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.5.0.pre1
 platform: ruby
 authors:
 - Kieran Klaassen
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-17 00:00:00.000000000 Z
+date: 2026-09-18 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.12'
+        version: 2.0.0.rc3
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.0.rc3
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '1.12'
+        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.
@@ -46,10 +53,25 @@ files:
 - lib/ruby_llm/skills/error.rb
 - lib/ruby_llm/skills/filesystem_loader.rb
 - lib/ruby_llm/skills/loader.rb
+- lib/ruby_llm/skills/marketplace.rb
+- lib/ruby_llm/skills/marketplace/bundle.rb
+- lib/ruby_llm/skills/marketplace/config.rb
+- lib/ruby_llm/skills/marketplace/fetcher.rb
+- lib/ruby_llm/skills/marketplace/github_repo.rb
+- lib/ruby_llm/skills/marketplace/gitlab_repo.rb
+- lib/ruby_llm/skills/marketplace/http.rb
+- lib/ruby_llm/skills/marketplace/locator.rb
+- lib/ruby_llm/skills/marketplace/lockfile.rb
+- lib/ruby_llm/skills/marketplace/manifest.rb
+- lib/ruby_llm/skills/marketplace/registry.rb
+- lib/ruby_llm/skills/marketplace/tarball.rb
 - lib/ruby_llm/skills/parser.rb
 - 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.rb
+- lib/ruby_llm/skills/tasks/marketplaces.rake
 - lib/ruby_llm/skills/tasks/skills.rake
 - lib/ruby_llm/skills/validator.rb
 - lib/ruby_llm/skills/version.rb
@@ -61,6 +83,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
@@ -71,11 +94,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.20
+signing_key:
 specification_version: 4
 summary: Agent Skills extension for RubyLLM
 test_files: []