ask-skills 0.5.0 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a8fc1e81c128476d7e6a3e5ce291213880f0d55a7261d41c7a99903e0c08431
-  data.tar.gz: 772dd0930f80b16fa8fb4b651245011899d5cf6406a8ad4a3a7c8002b17f435e
+  metadata.gz: 9f58cb080953d3d6668242ef9a23afeb53ecf5cbe110ded5129e9712c73ad4a0
+  data.tar.gz: 70b2e3ee9725fce113229de63f4a4f7f0028fc4433bb0cf82f9c2488f30a5c00
 SHA512:
-  metadata.gz: bb36fe31efde8c3757ee9dcd0be2b33e66dc105f5acc484432b1fd0217a6892032fdf5ded0a90fc7038e796398bb926a417cf877bea6cc46b6064296a524c649
-  data.tar.gz: 1e254bdaac3a75287aea4167f0d7a32781619e4836496809634cbc16244d35d18183782280c0476ca0853b00726ae4b46e445abddbc36098cf56c412477a59a8
+  metadata.gz: 35a85aa4833993da47e93adec5d930f26a0146d360eef97cee8ffec1d420b0ab19c6ca4009de94debf0bf5b61a1d6fa2bb819587ecd9a751d7b485f2c70ab961
+  data.tar.gz: 7168ecf11628dcf7e79beaffc32c56e44607a4ab57ea54cfaa867aaeb27eb8d09fb4a014b84a380f7377a29cc3061899919ec1048467029a8b54b4ba3e41b3dc

data/CHANGELOG.md

@@ -1,3 +1,14 @@
+## [0.5.1] - 2026-08-05
+
+### Added
+
+- **`Ask::Skills::LoadSkillTool`** — the LLM-facing tool that loads a
+  discovered skill's full instructions on demand (progressive skill
+  disclosure). Moved here from ask-agent (where it was
+  `Ask::Agent::Skills::LoadSkillTool`) so the gem owns discovery, listing,
+  and loading together. The tool is an `Ask::Tool` (ask-tools) and returns
+  `Ask::Result` (ask-core); ask-skills now depends on ask-tools.
+
 ## [0.5.0] - 2026-08-02
 
 ### Removed

data/lib/ask/skills/load_skill_tool.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require "ask/tools/tool"
+require "ask/result"
+
+module Ask
+  module Skills
+    # Tool that lets the LLM load a discovered skill's full instructions on
+    # demand. Skills are listed by name and description via progressive
+    # disclosure — the LLM decides which to load.
+    #
+    # Usage by the LLM: call load_skill with the skill name.
+    class LoadSkillTool < Ask::Tool
+      description "Load the full instructions for a skill by name. Use this when a listed skill seems relevant to the current task."
+
+      param :name, type: :string, desc: "Name of the skill to load (e.g., writing-guide)", required: true
+
+      def initialize(registry:)
+        @registry = registry
+        super()
+      end
+
+      def execute(name:)
+        skill = @registry&.[](name)
+        unless skill
+          available = @registry&.names&.join(", ") || "none"
+          return Ask::Result.failure("Skill '#{name}' not found. Available skills: #{available}")
+        end
+
+        # Return the full skill content so it can be injected into conversation
+        content = "## Skill: #{skill.name}\n#{skill.description}\n\n#{skill.instructions}"
+        Ask::Result.ok(data: { name: skill.name, content: content })
+      end
+
+      def name
+        "load_skill"
+      end
+    end
+  end
+end

data/lib/ask/skills/version.rb

@@ -1,5 +1,5 @@
 module Ask
   module Skills
-    VERSION = "0.5.0"
+    VERSION = "0.5.1"
   end
 end

data/lib/ask/skills.rb

@@ -8,6 +8,7 @@ module Ask
     autoload :Registry, "ask/skills/registry"
     autoload :Formatter, "ask/skills/formatter"
     autoload :Validator, "ask/skills/validator"
+    autoload :LoadSkillTool, "ask/skills/load_skill_tool"
 
     module Source
       autoload :Base, "ask/skills/sources/base"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-skills
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.5.1
 platform: ruby
 authors:
 - Kaka Ruto
@@ -9,6 +9,20 @@ bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: ask-tools
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.1'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -67,6 +81,7 @@ files:
 - lib/ask-skills.rb
 - lib/ask/skills.rb
 - lib/ask/skills/formatter.rb
+- lib/ask/skills/load_skill_tool.rb
 - lib/ask/skills/registry.rb
 - lib/ask/skills/skill.compose/SKILL.md
 - lib/ask/skills/skill.design/SKILL.md