ask-agent 0.9.1 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: edea591926e0360d2eb24990d423ef183e3abf99bc141df768a7ee11774db288
-  data.tar.gz: 2e5f013ee517281679e0ab717792ce3110411389b1b2df185b7d6c4c7636e106
+  metadata.gz: 80bddb94871d90233cf471e4a0667e6c2bb109edda83e772403000e6c86234bc
+  data.tar.gz: 9095268cfba594c639620991a60f490414b2834b7cd0d627732a7e17c1a4ba65
 SHA512:
-  metadata.gz: d7a430b5c791d0d25920836d604f529b1cac16e8c608f6ebaf1c04b0e5b449a1887c8b3a293ed1e2c6e75cdea23fc7c8614f0e80860c6cfad234951eaf8bc1f7
-  data.tar.gz: 580ccbb6e82210c446f7c8669d0b57a3fb90297156502d6a6c4a872c3f871c6838722c754fe02577083dc49f5cd28da9365d5f9da800d5e1921302bd8bd10958
+  metadata.gz: b792c3dcc1323e1c491c815d3ce8a58e7b253731f7cc5ed7189a4287b5acac5c2e5a5f9909d2b71705d805c8536057ad189e7d72482ef9cef06c27a48aa04b32
+  data.tar.gz: 4ca8a713e64926e58c97408ccaba3dc12e5b2f0f2ae9d4cd6f128ba2bebab4610ecaca559f9ff79e8d13706a6548b85f51e4be7ca176160239b8c38a17415984

data/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [0.10.0] — 2026-07-21
+
+### Added
+
+- **`askr skills` CLI commands** — new subcommands for discovering and inspecting skills:
+
+  ```bash
+  askr skills list              # All discovered skills with descriptions and tags
+  askr skills show rails_debug  # Full details + instructions + sibling files
+  askr skills search deploy     # Search by name, description, or tags
+  ```
+
+  Skills commands integrate with ask-skills 0.4.0, supporting enhanced frontmatter (tags, version, metadata) and sibling file discovery.
+
 ## [0.9.1] — 2026-07-21
 
 ### Changed

data/lib/ask/agent/cli.rb

@@ -15,6 +15,8 @@ module Ask
           cmd_schedule
         when "new"
           cmd_new(argv[1..])
+        when "skills"
+          cmd_skills(argv[1..])
         when "help", "--help", "-h", nil
           cmd_help
         else
@@ -150,6 +152,113 @@ module Ask
         puts "Run it:  askr run #{name}"
       end
 
+      def cmd_skills(args)
+        sub = args.first
+
+        case sub
+        when "list"
+          cmd_skills_list
+        when "show"
+          cmd_skills_show(args[1])
+        when "search"
+          cmd_skills_search(args[1])
+        else
+          puts "Usage: askr skills <list|show|search>"
+          puts ""
+          puts "Commands:"
+          puts "  list                  List all discovered skills"
+          puts "  show <name>           Show skill details and sibling files"
+          puts "  search <query>        Search skills by name, description, or tags"
+        end
+      end
+
+      def cmd_skills_list
+        require "ask/skills"
+        registry = Ask::Skills.discover
+
+        if registry.names.empty?
+          puts "No skills found."
+          return
+        end
+
+        puts "Discovered skills:"
+        puts ""
+        registry.names.sort.each do |name|
+          skill = registry[name]
+          puts "  #{skill.name}"
+          puts "    description: #{skill.description}"
+          puts "    tags:        #{skill.tags.join(", ")}" if skill.tags.any?
+          siblings = skill.siblings
+          if siblings.any?
+            summaries = siblings.map { |cat, files| "#{files.length} #{cat}" }.join(", ")
+            puts "    files:       #{summaries}"
+          end
+        end
+      end
+
+      def cmd_skills_show(name)
+        unless name
+          puts "Usage: askr skills show <name>"
+          exit 1
+        end
+
+        require "ask/skills"
+        registry = Ask::Skills.discover
+        skill = registry[name]
+
+        unless skill
+          puts "Skill not found: #{name}"
+          exit 1
+        end
+
+        puts "Name:        #{skill.name}"
+        puts "Description: #{skill.description}"
+        puts "Source:      #{skill.source}"
+        puts "Tags:        #{skill.tags.join(", ")}" if skill.tags.any?
+
+        if skill.siblings.any?
+          puts ""
+          puts "Sibling files:"
+          skill.siblings.each do |category, files|
+            puts "  #{category}/"
+            files.each { |f| puts "    #{f}" }
+          end
+        end
+
+        puts ""
+        puts "--- Instructions ---"
+        puts skill.instructions
+      end
+
+      def cmd_skills_search(query)
+        unless query
+          puts "Usage: askr skills search <query>"
+          exit 1
+        end
+
+        require "ask/skills"
+        registry = Ask::Skills.discover
+        query_down = query.downcase
+
+        matches = registry.names.select do |name|
+          skill = registry[name]
+          name.downcase.include?(query_down) ||
+            skill.description.downcase.include?(query_down) ||
+            skill.tags.any? { |t| t.downcase.include?(query_down) }
+        end
+
+        if matches.empty?
+          puts "No skills matching \"#{query}\"."
+          return
+        end
+
+        puts "Skills matching \"#{query}\":"
+        matches.sort.each do |name|
+          skill = registry[name]
+          puts "  #{skill.name} — #{skill.description}"
+        end
+      end
+
       def cmd_help
         puts <<~HELP
           Usage: askr <command> [options]
@@ -159,18 +268,26 @@ module Ask
             list                   List all discovered agents
             schedule               Start the scheduler for all scheduled agents
             new <name>             Scaffold a new agent directory
+            skills list            List all discovered skills
+            skills show <name>     Show skill details and instructions
+            skills search <query>  Search skills by name, description, or tags
             help                   Show this help
 
           Examples:
             askr list
             askr run health_check
-            askr run health_check "Check the server status"
-            askr new deploy_bot
             askr schedule
+            askr skills list
+            askr skills show rails_debug
+            askr skills search deploy
 
           Agent directories are discovered from:
             ./agents/<name>/agent.rb
             ./app/agents/<name>/agent.rb
+
+          Skills are discovered from:
+            ./agents/shared/skills/<name>/SKILL.md
+            ./app/agents/shared/skills/<name>/SKILL.md
         HELP
       end
 

data/lib/ask/agent/version.rb

@@ -2,6 +2,6 @@
 
 module Ask
   module Agent
-    VERSION = "0.9.1"
+    VERSION = "0.10.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-agent
 version: !ruby/object:Gem::Version
-  version: 0.9.1
+  version: 0.10.0
 platform: ruby
 authors:
 - Kaka Ruto