ask-skills 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1a4229cd07f55413b7de34a7463c2f582aac94898d804e8017cb9c0c02f2117b
+  data.tar.gz: d5c96783d0bbd7b5a9a79af85a1c33bdc59f5ffa41f9a612ff24fd61ccea37ef
+SHA512:
+  metadata.gz: 10c8342db4297f6d9417be6b63beb7962cd93a0476b421e15c736660a51ccde2c93141ecf6740f53755be02c0371c914ccf1a617759037964810dca38ab37c42
+  data.tar.gz: b5f26a5d36086ab1b918375672215fc9e7875ad5a58d43e149a4f744bf4841478bf2bdc1e20a29f9bd8d5f32769680605fe5fd4181cea1cd7b9e4e7d46c5b40b

data/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+## [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::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
+- 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/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Kaka Ruto
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,192 @@
+# ask-skills
+
+[![Gem Version](https://badge.fury.io/rb/ask-skills.svg)](https://badge.fury.io/rb/ask-skills)
+
+Discover, validate, and load agent skills from project directories, user config,
+and installed gems. Ships built-in skills for codebase exploration and debugging
+methodology.
+
+A **skill** is a markdown file containing step-by-step methodology for a specific
+domain task. It's listed in the agent's system prompt (just name + description)
+and loaded on-demand when the agent decides it needs domain guidance.
+
+## Installation
+
+```ruby
+gem "ask-skills"
+```
+
+Then:
+
+```ruby
+require "ask/skills"
+```
+
+## Quick Start
+
+```ruby
+# Discover all available skills
+registry = Ask::Skills.discover
+# => Finds skills from:
+#    - Built-in skills (skill.design, skill.compose)
+#    - Installed gems (ask-rails, ask-github, etc.)
+#    - .agents/skills/*/ in the project
+#    - ~/.config/ask/skills/*/ in home dir
+
+# List available skills
+registry.names
+# => ["skill.compose", "skill.design"]
+
+# Get a skill by name
+skill = registry["skill.design"]
+skill.name         # => "skill.design"
+skill.description  # => "How to design and write effective skills for the ask-rb ecosystem"
+skill.instructions # => markdown body with step-by-step methodology
+
+# Format for system prompt
+registry.format_for_prompt
+# => "## Available Skills\n\n- **skill.design**: How to design..."
+
+# XML format for machine parsing
+formatter = Ask::Skills::Formatter.new(registry)
+formatter.to_xml
+# => "<available_skills><skill><name>skill.design</name>..."
+
+# Validate skills
+errors = Ask::Skills::Validator.new(registry.skills.values).validate_all
+```
+
+## Priority Resolution
+
+When the same skill name exists in multiple places, priority determines which
+one is used. **First source wins:**
+
+| Priority | Source | Location |
+|----------|--------|----------|
+| 1 (highest) | Project-local | `.agents/skills/<name>/SKILL.md` |
+| 2 | User-global | `~/.config/ask/skills/<name>/SKILL.md` |
+| 3 | Installed gems | `Gem.find_files("ask/skills/*/SKILL.md")` |
+| 4 (lowest) | Built-in | Shipped with ask-skills gem |
+
+This means you can override any skill by placing a file with the same name in
+your project's `.agents/skills/` directory.
+
+## Skill Directory Convention
+
+```
+.agents/skills/
+├── db_debug/
+│   └── SKILL.md          ← project-local skill
+├── deploy/
+│   └── SKILL.md
+└── custom_check/
+    └── SKILL.md
+
+~/.config/ask/skills/
+├── my_workflow/
+│   └── SKILL.md          ← user-global skill
+└── team_patterns/
+    └── SKILL.md
+
+# From installed gems:
+ask-rails-0.2.0/lib/ask/skills/
+├── rails.db_debug/SKILL.md
+└── rails.deploy_pipeline/SKILL.md
+
+ask-github-0.1.0/lib/ask/skills/
+├── github.pr_review/SKILL.md
+└── github.issue_triage/SKILL.md
+```
+
+## Skill Format
+
+```markdown
+---
+name: rails.db_debug
+description: Step-by-step methodology for debugging database issues in Rails
+---
+
+When investigating database performance issues, follow these steps:
+
+1. **Understand the Schema** — Use ReadModel to inspect...
+2. **Check Indexes** — Query pg_indexes for missing indexes...
+3. **Explain Slow Queries** — Use EXPLAIN ANALYZE on...
+```
+
+## Built-in Skills
+
+| Skill | Description |
+|-------|-------------|
+| `skill.design` | How to design and write effective skills for the ask-rb ecosystem |
+| `skill.compose` | How skills interact, combine, and resolve in the ask-rb ecosystem |
+
+## API Reference
+
+### `Ask::Skills.discover(sources: nil)`
+
+Returns a `Registry` with skills from all sources, in priority order.
+Pass `sources:` to override with custom sources.
+
+### `Ask::Skills::Registry`
+
+| Method | Description |
+|--------|-------------|
+| `[]` | Lookup skill by name |
+| `names` | List all skill names |
+| `skills` | Hash of name → Skill |
+| `format_for_prompt` | Generate markdown section |
+
+### `Ask::Skills::Skill` (Data.define)
+
+| Attribute | Description |
+|-----------|-------------|
+| `name` | Unique identifier (e.g. `rails.db_debug`) |
+| `description` | One-line summary for system prompt |
+| `instructions` | Full markdown methodology body |
+| `source` | File path the skill was loaded from |
+
+### `Ask::Skills::Formatter`
+
+| Method | Description |
+|--------|-------------|
+| `to_prompt_section` | Markdown format for system prompt |
+| `to_xml` | XML format for machine parsing |
+
+### `Ask::Skills::Validator`
+
+| Method | Description |
+|--------|-------------|
+| `validate_all` | Validate all skills, return errors |
+| `validate` | Validate a single skill |
+
+## Custom Sources
+
+```ruby
+require "ask/skills"
+
+# Custom filesystem source
+custom = Ask::Skills::Source::Filesystem.new(dir: "/path/to/skills")
+registry = Ask::Skills.discover(sources: [custom])
+```
+
+## Gems That Ship Skills
+
+| Gem | Planned Skills |
+|---|---|
+| `ask-skills` (built-in) | skill.design, skill.compose |
+| `ask-rails` | rails.db_debug, rails.route_trouble, rails.deploy_pipeline |
+| `ask-github` | github.pr_review, github.issue_triage |
+| `ask-slack` | slack.compose |
+| `ask-tools-shell` | shell.patterns |
+| `ask-llm-providers` | providers.model_select |
+
+## Development
+
+```bash
+bundle install
+bundle exec rake test
+```
+
+## License
+
+MIT

data/lib/ask/skills/formatter.rb

@@ -0,0 +1,43 @@
+module Ask
+  module Skills
+    class Formatter
+      def initialize(skills)
+        @skills = skills.respond_to?(:skills) ? skills.skills : skills
+      end
+
+      def to_prompt_section
+        return "" if @skills.empty? || @skills.values.all? { |s| s.is_a?(Array) && s.empty? }
+
+        lines = ["", "## Available Skills", ""]
+        @skills.each_value do |skill|
+          lines << skill.to_prompt_entry
+        end
+        lines << ""
+        lines << "When a task matches a skill's description, load it for step-by-step methodology."
+        lines << ""
+        lines.join("\n")
+      end
+
+      def to_xml
+        return "" if @skills.empty?
+
+        lines = ["", "<available_skills>"]
+        @skills.each_value do |skill|
+          lines << "  <skill>"
+          lines << "    <name>#{escape_xml(skill.name)}</name>"
+          lines << "    <description>#{escape_xml(skill.description)}</description>"
+          lines << "  </skill>"
+        end
+        lines << "</available_skills>"
+        lines.join("\n")
+      end
+
+      private
+
+      def escape_xml(str)
+        str.gsub("&", "&amp;").gsub("<", "&lt;").gsub(">", "&gt;")
+           .gsub('"', "&quot;").gsub("'", "&apos;")
+      end
+    end
+  end
+end

data/lib/ask/skills/registry.rb

@@ -0,0 +1,43 @@
+module Ask
+  module Skills
+    class Registry
+      attr_reader :skills
+
+      def initialize(sources)
+        @skills = {}
+        @sources = sources
+        load_all
+      end
+
+      def [](name)
+        @skills[name]
+      end
+
+      def names
+        @skills.keys
+      end
+
+      def format_for_prompt
+        return "" if @skills.empty?
+        lines = ["", "## Available Skills", ""]
+        @skills.each_value do |skill|
+          lines << skill.to_prompt_entry
+        end
+        lines << ""
+        lines.join("\n")
+      end
+
+      private
+
+      def load_all
+        @sources.each do |source|
+          source.load.each do |skill|
+            next unless skill
+            # First source wins (project overrides gems, user overrides project)
+            @skills[skill.name] ||= skill
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ask/skills/skill.compose/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: skill.compose
+description: How skills interact, combine, and resolve in the ask-rb ecosystem
+---
+
+## Skill Resolution Priority
+
+Skills are discovered from multiple sources. When the same skill name exists in
+multiple places, the first source wins:
+
+1. **Built-in** (shipped with ask-skills gem) — lowest priority
+2. **Installed gems** (ask-rails, ask-github, etc.)
+3. **User-global** (`~/.config/ask/skills/`)
+4. **Project-local** (`.agents/skills/` in the project) — highest priority
+
+This means you can override any skill by placing a file with the same name in
+your project's `.agents/skills/` directory. Or provide personal defaults in
+`~/.config/ask/skills/`.
+
+## How Skills Appear in the System Prompt
+
+The agent's system prompt includes a section listing all available skills:
+
+```
+## Available Skills
+
+- **skill.design**: How to design and write effective skills
+- **rails.db_debug**: Step-by-step database debugging in Rails
+- **github.pr_review**: PR review workflow methodology
+```
+
+Only the **name and description** appear. The full instructions are NOT in the
+system prompt — they're loaded on-demand when the agent calls the skill.
+
+## When to Load a Skill
+
+Skills should be loaded when the task matches the skill's description. For example,
+if an investigation involves a slow database query, load `rails.db_debug`.
+
+If no skill's description matches the current task, proceed without loading any.
+Skills are optional — they provide methodology, not required capabilities.
+
+## Skills Can Reference Other Skills
+
+A skill's instructions can mention other skills:
+
+```markdown
+Step 3: If you find the query is slow, load `rails.db_debug` for
+detailed database investigation methodology.
+```
+
+This creates a hierarchy of methodology — a deploy skill might reference both
+a database migration skill and a monitoring skill.
+
+## Common Patterns
+
+**Sequential composition**: Load one skill, follow its steps, then load another
+when you reach a step that references it.
+
+**Alternative composition**: If a skill's first step fails, load the troubleshooting
+variant of that skill instead.
+
+**Reporting back**: After completing a skill's methodology, summarize what you found
+and what you did. The skill guided your process, but the results go back to the user.

data/lib/ask/skills/skill.design/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: skill.design
+description: How to design and write effective skills for the ask-rb ecosystem
+---
+
+A skill is a markdown file that teaches step-by-step methodology for a domain task.
+It differs from a tool (which provides a capability) in that it guides *how* to
+approach the work — the reasoning process, the order of operations, the pitfalls to avoid.
+
+## When to Create a Skill
+
+Create a skill when you have domain knowledge that:
+1. Follows a repeatable process (always debug DB this way)
+2. Requires tool composition (use these 3 tools in sequence)
+3. Is too long for the system prompt but too valuable to leave out
+
+Do NOT create a skill for:
+- Simple tool knowledge (just update the system prompt or tool description)
+- API reference documentation (that's what context.rb is for in service gems)
+- One-time tasks that won't repeat
+
+## Skill File Format
+
+Each skill is a directory with a `SKILL.md` file:
+
+```
+lib/ask/skills/<name>/
+└── SKILL.md
+```
+
+The `SKILL.md` has YAML frontmatter followed by markdown body:
+
+```markdown
+---
+name: domain.skill_name       # Unique identifier (lowercase, dots allowed)
+description: One-line summary  # Shown in system prompt skill list
+version: 1                     # Optional
+---
+
+Instructions body...
+```
+
+## Writing Good Skill Content
+
+1. **Start with context** — When would someone use this skill? What problem does it solve?
+2. **Use numbered steps** — Clear progression, one concept per step
+3. **Reference tools by name** — "Use `ReadModel.new.call(name: "User")`" not "check the model"
+4. **Show examples** — Concrete tool invocations the agent can copy
+5. **Explain reasoning** — Not just what to do, but why this order matters
+6. **Handle failure** — "If this step fails, try..." for common pitfalls
+7. **Keep focused** — One skill, one domain procedure. If it's too long, split into multiple skills.
+
+## Skill Naming Convention
+
+```
+<domain>.<name>
+```
+
+Examples:
+- `rails.db_debug` — Rails-specific database debugging
+- `github.pr_review` — GitHub PR review workflow
+- `shell.patterns` — Shell tool composition patterns
+
+## Testing Your Skill
+
+After creating a skill file, verify:
+1. Frontmatter has both `name` and `description`
+2. Name is lowercase with only letters, numbers, dots, hyphens
+3. Description is a complete sentence
+4. Instructions have numbered steps
+5. Tools are referenced by their full Ruby class names
+6. The skill directory contains `SKILL.md` (not `skill.md` or `README.md`)

data/lib/ask/skills/skill.rb

@@ -0,0 +1,13 @@
+module Ask
+  module Skills
+    Skill = Data.define(:name, :description, :instructions, :source) do
+      def to_s
+        "#{name}: #{description}"
+      end
+
+      def to_prompt_entry
+        "- **#{name}**: #{description}"
+      end
+    end
+  end
+end

data/lib/ask/skills/sources/base.rb

@@ -0,0 +1,15 @@
+module Ask
+  module Skills
+    module Source
+      class Base
+        def load
+          raise NotImplementedError
+        end
+
+        def name
+          raise NotImplementedError
+        end
+      end
+    end
+  end
+end

data/lib/ask/skills/sources/filesystem.rb

@@ -0,0 +1,67 @@
+module Ask
+  module Skills
+    module Source
+      class Filesystem < Base
+        def initialize(dir: nil, project_dir: nil, user_dir: nil)
+          @path = dir || project_dir || (user_dir ? File.expand_path(user_dir) : nil)
+        end
+
+        def load
+          return [] unless @path && Dir.exist?(@path)
+          skills = []
+          Dir.entries(@path).each do |entry|
+            next if entry.start_with?(".")
+            skill_dir = File.join(@path, entry)
+            next unless File.directory?(skill_dir)
+            skill_file = File.join(skill_dir, "SKILL.md")
+            next unless File.exist?(skill_file)
+            next if File.directory?(skill_file)
+            if (skill = parse_skill(skill_file))
+              skills << skill
+            end
+          end
+          skills
+        end
+
+        private
+
+        def parse_skill(path)
+          content = File.read(path)
+          frontmatter = parse_frontmatter(content)
+          body = extract_body(content)
+
+          name = frontmatter["name"] || File.basename(File.dirname(path))
+          description = frontmatter["description"] || ""
+
+          return nil if description.empty?
+
+          Skill.new(name: name, description: description, instructions: body, source: path)
+        end
+
+        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
+
+        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
+end

data/lib/ask/skills/sources/gems.rb

@@ -0,0 +1,62 @@
+module Ask
+  module Skills
+    module Source
+      class Gems < Base
+        GLOB = "ask/skills/*/SKILL.md"
+
+        def name
+          "Gems"
+        end
+
+        def load
+          skills = []
+          Gem.find_files(GLOB).each do |path|
+            if (skill = parse_skill(path))
+              skills << skill
+            end
+          end
+          skills
+        end
+
+        private
+
+        def parse_skill(path)
+          content = File.read(path)
+          frontmatter = parse_frontmatter(content)
+          body = extract_body(content)
+
+          name = frontmatter["name"] || File.basename(File.dirname(path))
+          description = frontmatter["description"] || ""
+
+          return nil if description.empty?
+
+          Skill.new(name: name, description: description, instructions: body, source: path)
+        end
+
+        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
+
+        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/, "")
+        end
+      end
+    end
+  end
+end

data/lib/ask/skills/validator.rb

@@ -0,0 +1,37 @@
+module Ask
+  module Skills
+    class Validator
+      ValidationError = Data.define(:skill_name, :message)
+
+      NAME_PATTERN = /\A[a-z0-9_.-]+\z/
+
+      def initialize(skills)
+        @skills = skills
+      end
+
+      def validate_all
+        errors = []
+        names = {}
+        @skills.each do |skill|
+          errors.concat(validate(skill))
+          if names[skill.name]
+            errors << ValidationError.new(skill.name, "Duplicate skill name from #{names[skill.name]} and #{skill.source}")
+          end
+          names[skill.name] = skill.source
+        end
+        errors
+      end
+
+      def validate(skill)
+        errors = []
+        errors << ValidationError.new(skill.name, "Name is empty") if skill.name.empty?
+        errors << ValidationError.new(skill.name, "Description is empty") if skill.description.empty?
+        errors << ValidationError.new(skill.name, "Instructions are empty") if skill.instructions.strip.empty?
+        if !skill.name.empty? && skill.name !~ NAME_PATTERN
+          errors << ValidationError.new(skill.name, "Name must be lowercase, with only letters, numbers, dots, hyphens, underscores")
+        end
+        errors
+      end
+    end
+  end
+end

data/lib/ask/skills/version.rb

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

data/lib/ask/skills.rb

@@ -0,0 +1,41 @@
+require_relative "skills/version"
+
+module Ask
+  module Skills
+    class Error < StandardError; end
+
+    autoload :Skill, "ask/skills/skill"
+    autoload :Registry, "ask/skills/registry"
+    autoload :Formatter, "ask/skills/formatter"
+    autoload :Validator, "ask/skills/validator"
+
+    module Source
+      autoload :Base, "ask/skills/sources/base"
+      autoload :Filesystem, "ask/skills/sources/filesystem"
+      autoload :Gems, "ask/skills/sources/gems"
+    end
+
+    class << self
+      def discover(sources: nil)
+        Registry.new(sources || default_sources)
+      end
+
+      def default_sources
+        [
+          # Highest priority first — first source wins in Registry
+          Source::Filesystem.new(project_dir: ".agents/skills"),
+          Source::Filesystem.new(user_dir: "~/.config/ask/skills"),
+          Source::Gems.new,
+          Source::Filesystem.new(dir: builtin_skills_dir),
+        ]
+      end
+
+      def builtin_skills_dir
+        # Skills live in lib/ask/skills/<skill_name>/SKILL.md
+        # __dir__ in this file (lib/ask/skills.rb) is lib/ask/
+        # The skill directories are in lib/ask/skills/
+        File.join(__dir__, "skills")
+      end
+    end
+  end
+end

data/lib/ask-skills.rb

@@ -0,0 +1 @@
+require_relative "ask/skills"

metadata

@@ -0,0 +1,103 @@
+--- !ruby/object:Gem::Specification
+name: ask-skills
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Kaka Ruto
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.25'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.25'
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: Discovers, validates, and formats agent skills from project directories,
+  user config, and installed gems. Ships built-in skills (codebase exploration, debugging
+  methodology). Each skill is a markdown file with step-by-step instructions that
+  the agent loads on demand.
+email:
+- kaka@myrrlabs.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/ask-skills.rb
+- lib/ask/skills.rb
+- lib/ask/skills/formatter.rb
+- lib/ask/skills/registry.rb
+- lib/ask/skills/skill.compose/SKILL.md
+- lib/ask/skills/skill.design/SKILL.md
+- lib/ask/skills/skill.rb
+- lib/ask/skills/sources/base.rb
+- lib/ask/skills/sources/filesystem.rb
+- lib/ask/skills/sources/gems.rb
+- lib/ask/skills/validator.rb
+- lib/ask/skills/version.rb
+homepage: https://github.com/ask-rb/ask-skills
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/ask-rb/ask-skills
+  source_code_uri: https://github.com/ask-rb/ask-skills
+  changelog_uri: https://github.com/ask-rb/ask-skills/blob/master/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: Skill discovery and management for the ask-rb ecosystem
+test_files: []