ask-skills 0.5.0 → 0.5.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a8fc1e81c128476d7e6a3e5ce291213880f0d55a7261d41c7a99903e0c08431
-  data.tar.gz: 772dd0930f80b16fa8fb4b651245011899d5cf6406a8ad4a3a7c8002b17f435e
+  metadata.gz: e6436a6d7b9f9dd7ad96d06b446caa7eee713de9823664046a249ace15253eca
+  data.tar.gz: e0b1872fccd18cfe3ade452a2082579c9e0d380679255072a26e64f288ede241
 SHA512:
-  metadata.gz: bb36fe31efde8c3757ee9dcd0be2b33e66dc105f5acc484432b1fd0217a6892032fdf5ded0a90fc7038e796398bb926a417cf877bea6cc46b6064296a524c649
-  data.tar.gz: 1e254bdaac3a75287aea4167f0d7a32781619e4836496809634cbc16244d35d18183782280c0476ca0853b00726ae4b46e445abddbc36098cf56c412477a59a8
+  metadata.gz: 299aa11f1f6ce8e9f7bdfcbe5104cb9b30279da474ac4216162ef85350308ac2bc5c82f266a612e978d09e7986f3bf72d6f5edd8f4e2b91218157e82d1bfb60a
+  data.tar.gz: 52b174942a932c0327993be99fb95484762db31594c6cc1a7c4888e82953c8df26ec678787a2c2b56a0f0b11808a5e2004b49cfb40b77a13c3ba000b8ebca407

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.2"
   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.2
 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.6.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.6.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
@@ -97,7 +112,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.18
 specification_version: 4
 summary: Skill discovery and management for the ask-rb ecosystem
 test_files: []