ask-skills 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1a4229cd07f55413b7de34a7463c2f582aac94898d804e8017cb9c0c02f2117b
-  data.tar.gz: d5c96783d0bbd7b5a9a79af85a1c33bdc59f5ffa41f9a612ff24fd61ccea37ef
+  metadata.gz: 865bd7d0c3e8690a68427e17e2aa43a18a8989121efde557e0286aaa164dcb92
+  data.tar.gz: f055f61588d77a5db7c7feb69e947d1ad8f67380dda23eb5ae79e0ea2befa3d2
 SHA512:
-  metadata.gz: 10c8342db4297f6d9417be6b63beb7962cd93a0476b421e15c736660a51ccde2c93141ecf6740f53755be02c0371c914ccf1a617759037964810dca38ab37c42
-  data.tar.gz: b5f26a5d36086ab1b918375672215fc9e7875ad5a58d43e149a4f744bf4841478bf2bdc1e20a29f9bd8d5f32769680605fe5fd4181cea1cd7b9e4e7d46c5b40b
+  metadata.gz: 86fd99532c1c93c1bd43b66931a626ecd2478fc22dae6668ee1902441bfaef6b643cfc7008d952a5a7e43be63b44de0fa876f914d2e30980dff531312f9c1445
+  data.tar.gz: 7c49b38d6ac9678f051b85eed6f3b4841536e38861fcd8ee012556376fe3857033dd915844a53c05f549e5724da2dc1b5a3c003634ea8aa7e977cc0b8e89d1af

data/CHANGELOG.md

@@ -1,28 +1,28 @@
 # Changelog
 
+## [0.2.0] - 2026-06-10
+
+### Added
+- Skills shipped with methodology gems (ask-rails, ask-github, ask-slack,
+  ask-tools-shell, ask-llm-providers) — 8 skills total
+- `Ask::Skills.load_file(path)` — load any markdown file as an ad-hoc skill
+- ask-agent integration: auto-discovery and system prompt injection on
+  `Ask::Agent::Session` initialization
+- `session.skill(name)` — load a skill by name (or file path) and inject
+  its full instructions into the conversation
+
+### Changed
+- `Ask::Skills.discover` now discovers skills from methodology gem gems too
+  (via `Gem.find_files`)
+
 ## [0.1.0] - 2026-06-10
 
 ### Added
 - Initial release
 - `Ask::Skills::Skill` — Data.define with name, description, instructions, source
-  - `to_s` and `to_prompt_entry` formatting methods
-- `Ask::Skills::Registry` — holds discovered skills with:
-  - `[]` lookup, `names` list, `format_for_prompt` markdown output
-  - Priority resolution: first source wins
+- `Ask::Skills::Registry` — holds discovered skills
 - `Ask::Skills::Formatter` — generates markdown and XML output
 - `Ask::Skills::Validator` — validates required fields, name format, duplicates
-- `Ask::Skills.discover` — discover skills from all configured sources:
-  1. Project-local (`.agents/skills/`) — highest priority
-  2. User-global (`~/.config/ask/skills/`)
-  3. Installed gems (via `Gem.find_files`)
-  4. Built-in (skill.design, skill.compose) — lowest priority
-- `Ask::Skills::Source::Filesystem` — scan a directory for `*/SKILL.md` files
-- `Ask::Skills::Source::Gems` — discover skills from all installed gems
-- Built-in skills:
-  - `skill.design` — How to design and write effective skills
-  - `skill.compose` — How skills interact, combine, and resolve
+- `Ask::Skills.discover` — discover skills from all configured sources
+- Built-in skills (skill.design, skill.compose)
 - Full test suite with 68 tests
-- Frontmatter parsing (name, description, optional metadata)
-- YAML frontmatter support with quoted value handling
-- Error handling for missing directories, malformed skills
-- Thread-safe read-only registry access

data/lib/ask/skills/version.rb

@@ -1,5 +1,5 @@
 module Ask
   module Skills
-    VERSION = "0.1.0"
+    VERSION = "0.2.0"
   end
 end

data/lib/ask/skills.rb

@@ -36,6 +36,56 @@ module Ask
         # The skill directories are in lib/ask/skills/
         File.join(__dir__, "skills")
       end
+
+      # Load a skill from an arbitrary markdown file path.
+      # Parses frontmatter if present, otherwise uses the filename as the skill name.
+      #
+      # @param path [String] absolute or relative path to a markdown (.md) file
+      # @return [Skill] a skill with the file's content as instructions
+      # @raise [Errno::ENOENT] if the file does not exist
+      def load_file(path)
+        path = File.expand_path(path)
+        content = File.read(path)
+        frontmatter = parse_frontmatter(content)
+        body = extract_body(content)
+
+        name = frontmatter["name"] || File.basename(path, ".md")
+        description = frontmatter["description"] || "Ad-hoc skill loaded from #{File.basename(path)}"
+
+        Skill.new(
+          name: name,
+          description: description,
+          instructions: body.empty? ? content : body,
+          source: path
+        )
+      end
+
+      # Simple frontmatter parsing for skill files.
+      # Returns a hash of key-value pairs from between --- markers.
+      def parse_frontmatter(content)
+        return {} unless content.start_with?("---\n")
+        end_idx = content.index("\n---\n", 4)
+        return {} unless end_idx
+        yaml_str = content[4...end_idx]
+        yaml = {}
+        yaml_str.split("\n").each do |line|
+          if (m = line.match(/\A(\w+):\s*(.+)\z/))
+            value = m[2].strip
+            value = value.gsub(/\A"|"\z/, "").gsub(/\A'|'\z/, "")
+            yaml[m[1]] = value
+          end
+        end
+        yaml
+      end
+
+      # Extract the markdown body from a file with frontmatter.
+      def extract_body(content)
+        return content unless content.start_with?("---\n")
+        end_idx = content.index("\n---\n", 4)
+        return content unless end_idx
+        body = content[(end_idx + 5)..] || ""
+        body.sub(/\A\n/, "").strip
+      end
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-skills
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Kaka Ruto