ruby_llm-skills 0.4.0.pre1 → 0.5.0.pre1

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.4.0.pre1"
+    VERSION = "0.5.0.pre1"
   end
 end

data/lib/ruby_llm/skills.rb

@@ -11,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)
@@ -73,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,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby_llm-skills
 version: !ruby/object:Gem::Version
-  version: 0.4.0.pre1
+  version: 0.5.0.pre1
 platform: ruby
 authors:
 - Kieran Klaassen
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-10 00:00:00.000000000 Z
+date: 2026-09-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby_llm
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.0.rc2
+        version: 2.0.0.rc3
     - - "<"
       - !ruby/object:Gem::Version
         version: '3'
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.0.rc2
+        version: 2.0.0.rc3
     - - "<"
       - !ruby/object:Gem::Version
         version: '3'
@@ -53,11 +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
@@ -84,7 +98,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 1.3.1
 requirements: []
-rubygems_version: 3.4.10
+rubygems_version: 3.4.20
 signing_key:
 specification_version: 4
 summary: Agent Skills extension for RubyLLM