agent-skills 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 12c19e9b0e8f423011789431c689886729b9b202f8b5c7909d7b277cff4972ad
-  data.tar.gz: 934a40807c941be02edbdf9d54a3c799be6c3e8f0cb7e60626077230d01808f3
+  metadata.gz: b21717e2fd5e723024f9d8e286fea1704a32618bc3ffb159f6b9bb33862b8efc
+  data.tar.gz: 87e6b34be5cd83b41596579d6307f7d4cf732f49f232ff73f27f25325e2ca74c
 SHA512:
-  metadata.gz: 5bd4834187316d17fbf7043aa9eb5150c244180726223db358b114dbbf066eb2e440f4120d0878d74d8402a22053ff9d5484f8fa95b6a77b67955b3fa11f2d6a
-  data.tar.gz: cc639e09c08174ffb49dd1314e1930421a5e4f6d475ca6b53eece60610c7c15c80023274ccd10b9a8272e91495389f834003ae64fcb87eb8a26d4ffa299a8d55
+  metadata.gz: 04e6eb35d7cfa2be064084832e4df1606af54bf28647ef1b3d04a4884833999583409ec6e1c402e60ce669ac7d4ab1f6dc16a8b2717487505ca0daed21195384
+  data.tar.gz: 1524dc2694ee37b84804ea334cbc69f2278a0c13b801ddd966eaae3e18b26cbcf88823e96e1f638d76aafa5dc3fe05d47a2d6333e3adca2e9a2bd26c015586ba

checksums.yaml.gz.sig

@@ -0,0 +1,2 @@
+��Q
�.�1�Zޯvkݛ�F�����<Y�ϛ��Fò�O��S�i7���i:�_-�(����`D4�&�N|3�F�4��F�Gd�������%t`�Mӻ�
�D�^�Lz5+�A�V׹~����\/�
+�۠4R��-z*�����j�p��m%�$���FƢ��u.�Ӱ��U4�1�5��1[V#@Y�[r��U_��

data/bake/agent/skills.rb

@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2025, by Shopify Inc.
-# Copyright, 2025-2026, by Samuel Williams.
+# Copyright, 2026, by Shopify Inc.
 
 require_relative "../../lib/agent/skills/installer"
 
@@ -62,7 +61,7 @@ def install(gem: nil)
 		installed = @installer.install_gem_skills(gem)
 		if installed
 			puts "Installed #{installed.length} skills from gem '#{gem}':"
-			installed.each {|skill_name| puts "  #{skill_name}"}
+			installed.each{|skill_name| puts "  #{skill_name}"}
 		else
 			puts "No skills found for gem '#{gem}'"
 		end
@@ -70,7 +69,7 @@ def install(gem: nil)
 		installed = @installer.install_all_skills
 		if installed.any?
 			puts "Installed #{installed.length} skills:"
-			installed.each {|skill_name| puts "  #{skill_name}"}
+			installed.each{|skill_name| puts "  #{skill_name}"}
 		else
 			puts "No gems with skills found"
 		end

data/context/getting-started.md

@@ -1,71 +1,54 @@
-# Getting Started with Agent Skills
+# Getting Started
 
-This guide explains how to discover, inspect, and install agent skills provided by Ruby gems.
+`agent-skills` discovers and installs reusable agent skills distributed by Ruby gems.
 
 ## Installation
 
-Add `agent-skills` to the consuming project:
-
 ```bash
 $ bundle add agent-skills
-```
-
-List the skills available from installed gems:
-
-```bash
 $ bundle exec bake agent:skills:list
-```
-
-Install them into the project:
-
-```bash
 $ bundle exec bake agent:skills:install
 ```
 
-## Source and Destination Directories
+## Providing Skills
 
-Provider gems publish skills beneath `skills/`:
+Provider gems place one or more skill packages beneath a top-level `skills/` directory:
 
 ```text
-provider-gem/
-└── skills/
-    └── ruby-testing/
-        ├── SKILL.md
-        ├── references/
-        └── scripts/
+your-gem/
+├── skills/
+│   └── ruby-testing/
+│       ├── SKILL.md
+│       ├── references/
+│       └── scripts/
+├── lib/
+└── your-gem.gemspec
 ```
 
-The consuming project receives them beneath `.agents/skills/`:
+Each `SKILL.md` starts with YAML frontmatter containing a `name` and `description`. The name must match the directory.
 
-```text
-consumer-project/
-└── .agents/
-    └── skills/
-        ├── ruby-testing/
-        └── .agent-skills.yaml
-```
-
-## Providing a Skill
+## Installing Skills
 
-Create a directory beneath your gem's top-level `skills/` directory. Add a `SKILL.md` file with required frontmatter:
+Install every discovered skill:
 
-```markdown
----
-name: ruby-testing
-description: Test Ruby changes with the project's configured test framework.
----
+```bash
+$ bake agent:skills:install
+```
 
-# Ruby Testing
+Install from a particular gem:
 
-Run the narrowest relevant test first, then run the complete suite.
+```bash
+$ bake agent:skills:install --gem sus
 ```
 
-The `name` must match the containing directory. Include the complete `skills/**/*` tree in the gemspec.
-
-## Installation Ownership
+Installed skills are copied to `.agents/skills/`. An ownership registry prevents dependencies from overwriting project-authored skills or skills supplied by another gem.
 
-`agent-skills` writes `.agents/skills/.agent-skills.yaml` to record which gem owns each installed skill. It will update skills owned by the same gem, but refuses to overwrite unmanaged skills or skills owned by another gem.
+## Inspecting Skills
 
-## Safety
+```bash
+$ bake agent:skills:list
+$ bake agent:skills:list --gem sus
+$ bake agent:skills:show --gem sus --skill ruby-testing
+```
 
-Skills may contain scripts and operational instructions. Inspect skills with `bake agent:skills:list` and `bake agent:skills:show` before installation when evaluating an unfamiliar dependency.
+Review unfamiliar skills before installing them, especially when they include scripts.

data/context/index.yaml

@@ -1,10 +1,15 @@
+# Automatically generated context index for Utopia::Project guides.
+# Do not edit then files in this directory directly, instead edit the guides and then run `bake utopia:project:agent:context:update`.
 ---
 description: Install and manage agent skills from Ruby gems.
 metadata:
+  bug_tracker_uri: https://github.com/socketry/agent-skills/issues
+  changelog_uri: https://github.com/socketry/agent-skills/blob/main/releases.md
   documentation_uri: https://socketry.github.io/agent-skills/
   funding_uri: https://github.com/sponsors/ioquatix/
   source_code_uri: https://github.com/socketry/agent-skills.git
 files:
 - path: getting-started.md
-  title: Getting Started with Agent Skills
-  description: Discover, inspect, and install agent skills provided by Ruby gems.
+  title: Getting Started
+  description: "`agent-skills` discovers and installs reusable agent skills distributed
+    by Ruby gems."

data/lib/agent/skills/definition.rb

@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2025, by Shopify Inc.
-# Copyright, 2025-2026, by Samuel Williams.
+# Copyright, 2026, by Shopify Inc.
 
 module Agent
 	module Skills

data/lib/agent/skills/installer.rb

@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2025, by Shopify Inc.
-# Copyright, 2025-2026, by Samuel Williams.
+# Copyright, 2026, by Shopify Inc.
 
 require "fileutils"
 require "rubygems"
@@ -59,7 +58,7 @@ module Agent
 			#
 			# @parameter gem_name [String] The gem name to find.
 			def find_gem_with_skills(gem_name)
-				specification = @specifications.find {|candidate| candidate.name == gem_name}
+				specification = @specifications.find{|candidate| candidate.name == gem_name}
 				return unless specification
 				
 				build_gem_information(specification)
@@ -81,7 +80,7 @@ module Agent
 				skills = list_skills(gem_name)
 				return unless skills
 				
-				definition = skills.find {|skill| skill.name == skill_name}
+				definition = skills.find{|skill| skill.name == skill_name}
 				File.read(definition.skill_file) if definition
 			end
 			
@@ -180,13 +179,13 @@ module Agent
 			end
 			
 			def install_gems(gems)
-				definitions = gems.flat_map {|gem| gem[:skills]}
+				definitions = gems.flat_map{|gem| gem[:skills]}
 				return [] if definitions.empty?
 				
 				validate_unique_skills(definitions)
 				
 				registry = Registry.new(File.join(@skills_path, Registry::FILE_NAME))
-				definitions.each {|definition| validate_destination(definition, registry)}
+				definitions.each{|definition| validate_destination(definition, registry)}
 				
 				stale_skills = gems.flat_map do |gem|
 					current_names = gem[:skills].map(&:name)
@@ -196,17 +195,17 @@ module Agent
 				definitions.each do |definition|
 					registry.claim(definition.name, definition.provider_name, definition.provider_version)
 				end
-				stale_skills.each {|skill_name| registry.release(skill_name)}
+				stale_skills.each{|skill_name| registry.release(skill_name)}
 				registry.save
 				
-				definitions.each {|definition| copy_skill(definition)}
-				stale_skills.each {|skill_name| remove_skill(skill_name)}
+				definitions.each{|definition| copy_skill(definition)}
+				stale_skills.each{|skill_name| remove_skill(skill_name)}
 				
 				definitions.map(&:name)
 			end
 			
 			def validate_unique_skills(definitions)
-				duplicates = definitions.group_by(&:name).select {|_name, matches| matches.length > 1}
+				duplicates = definitions.group_by(&:name).select{|_name, matches| matches.length > 1}
 				return if duplicates.empty?
 				
 				details = duplicates.map do |name, matches|

data/lib/agent/skills/registry.rb

@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2025, by Shopify Inc.
-# Copyright, 2025-2026, by Samuel Williams.
+# Copyright, 2026, by Shopify Inc.
 
 require "fileutils"
 require "yaml"

data/lib/agent/skills/version.rb

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2025, by Shopify Inc.
-# Copyright, 2025-2026, by Samuel Williams.
+# Copyright, 2026, by Shopify Inc.
+# Copyright, 2026, by Samuel Williams.
 
 module Agent
 	module Skills
-		VERSION = "0.0.2"
+		VERSION = "0.0.3"
 	end
 end

data/lib/agent/skills.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2025, by Shopify Inc.
-# Copyright, 2025-2026, by Samuel Williams.
+# Copyright, 2026, by Shopify Inc.
+# Copyright, 2026, by Samuel Williams.
 
 require_relative "skills/version"
 require_relative "skills/definition"

data/license.md

@@ -1,7 +1,7 @@
 # MIT License
 
-Copyright, 2025, by Shopify Inc.  
-Copyright, 2025-2026, by Samuel Williams.  
+Copyright, 2026, by Shopify Inc.  
+Copyright, 2026, by Samuel Williams.  
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/readme.md

@@ -103,10 +103,46 @@ bake agent:skills:install --gem sus
 
 This gem provides contextual documentation in `context/` for use with [`agent-context`](https://github.com/socketry/agent-context).
 
+## Releases
+
+Please see the [project releases](https://socketry.github.io/agent-skills/releases/index) for all releases.
+
+### v0.0.0
+
+  - Initial release.
+  - Discover and validate skills provided by Ruby gems.
+  - Install project-scoped skills with ownership and collision protection.
+
 ## Contributing
 
-We welcome contributions. Please add tests for behavioral changes and run the test suite before opening a pull request.
+We welcome contributions to this project.
+
+1.  Fork the repository.
+2.  Create your feature branch (`git checkout -b my-new-feature`).
+3.  Commit your changes (`git commit -am 'Add some feature.'`).
+4.  Push to the branch (`git push origin my-new-feature`).
+5.  Create a new pull request.
+
+### Running Tests
+
+To run the test suite:
+
+``` bash
+$ bundle exec sus
+```
+
+### Making Releases
+
+To make a new release:
+
+``` bash
+$ bundle exec bake gem:release:patch # or minor or major
+```
 
 ### Developer Certificate of Origin
 
-Contributors must comply with the [Developer Certificate of Origin](https://developercertificate.org/).
+In order to protect users of this project, we require all contributors to comply with the [Developer Certificate of Origin](https://developercertificate.org/). This ensures that all contributions are properly licensed and attributed.
+
+### Community Guidelines
+
+This project is best served by a collaborative and respectful environment. Treat each other professionally, respect differing viewpoints, and engage constructively. Harassment, discrimination, or harmful behavior is not tolerated. Communicate clearly, listen actively, and support one another. If any issues arise, please inform the project maintainers.

metadata

@@ -1,13 +1,42 @@
 --- !ruby/object:Gem::Specification
 name: agent-skills
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Samuel Williams
 - Shopify Inc.
 bindir: bin
-cert_chain: []
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIE2DCCA0CgAwIBAgIBATANBgkqhkiG9w0BAQsFADBhMRgwFgYDVQQDDA9zYW11
+  ZWwud2lsbGlhbXMxHTAbBgoJkiaJk/IsZAEZFg1vcmlvbnRyYW5zZmVyMRIwEAYK
+  CZImiZPyLGQBGRYCY28xEjAQBgoJkiaJk/IsZAEZFgJuejAeFw0yMjA4MDYwNDUz
+  MjRaFw0zMjA4MDMwNDUzMjRaMGExGDAWBgNVBAMMD3NhbXVlbC53aWxsaWFtczEd
+  MBsGCgmSJomT8ixkARkWDW9yaW9udHJhbnNmZXIxEjAQBgoJkiaJk/IsZAEZFgJj
+  bzESMBAGCgmSJomT8ixkARkWAm56MIIBojANBgkqhkiG9w0BAQEFAAOCAY8AMIIB
+  igKCAYEAomvSopQXQ24+9DBB6I6jxRI2auu3VVb4nOjmmHq7XWM4u3HL+pni63X2
+  9qZdoq9xt7H+RPbwL28LDpDNflYQXoOhoVhQ37Pjn9YDjl8/4/9xa9+NUpl9XDIW
+  sGkaOY0eqsQm1pEWkHJr3zn/fxoKPZPfaJOglovdxf7dgsHz67Xgd/ka+Wo1YqoE
+  e5AUKRwUuvaUaumAKgPH+4E4oiLXI4T1Ff5Q7xxv6yXvHuYtlMHhYfgNn8iiW8WN
+  XibYXPNP7NtieSQqwR/xM6IRSoyXKuS+ZNGDPUUGk8RoiV/xvVN4LrVm9upSc0ss
+  RZ6qwOQmXCo/lLcDUxJAgG95cPw//sI00tZan75VgsGzSWAOdjQpFM0l4dxvKwHn
+  tUeT3ZsAgt0JnGqNm2Bkz81kG4A2hSyFZTFA8vZGhp+hz+8Q573tAR89y9YJBdYM
+  zp0FM4zwMNEUwgfRzv1tEVVUEXmoFCyhzonUUw4nE4CFu/sE3ffhjKcXcY//qiSW
+  xm4erY3XAgMBAAGjgZowgZcwCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0O
+  BBYEFO9t7XWuFf2SKLmuijgqR4sGDlRsMC4GA1UdEQQnMCWBI3NhbXVlbC53aWxs
+  aWFtc0BvcmlvbnRyYW5zZmVyLmNvLm56MC4GA1UdEgQnMCWBI3NhbXVlbC53aWxs
+  aWFtc0BvcmlvbnRyYW5zZmVyLmNvLm56MA0GCSqGSIb3DQEBCwUAA4IBgQB5sxkE
+  cBsSYwK6fYpM+hA5B5yZY2+L0Z+27jF1pWGgbhPH8/FjjBLVn+VFok3CDpRqwXCl
+  xCO40JEkKdznNy2avOMra6PFiQyOE74kCtv7P+Fdc+FhgqI5lMon6tt9rNeXmnW/
+  c1NaMRdxy999hmRGzUSFjozcCwxpy/LwabxtdXwXgSay4mQ32EDjqR1TixS1+smp
+  8C/NCWgpIfzpHGJsjvmH2wAfKtTTqB9CVKLCWEnCHyCaRVuKkrKjqhYCdmMBqCws
+  JkxfQWC+jBVeG9ZtPhQgZpfhvh+6hMhraUYRQ6XGyvBqEUe+yo6DKIT3MtGE2+CP
+  eX9i9ZWBydWb8/rvmwmX2kkcBbX0hZS1rcR593hGc61JR6lvkGYQ2MYskBveyaxt
+  Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
+  voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
+  -----END CERTIFICATE-----
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
@@ -44,6 +73,8 @@ homepage: https://github.com/socketry/agent-skills
 licenses:
 - MIT
 metadata:
+  bug_tracker_uri: https://github.com/socketry/agent-skills/issues
+  changelog_uri: https://github.com/socketry/agent-skills/blob/main/releases.md
   documentation_uri: https://socketry.github.io/agent-skills/
   funding_uri: https://github.com/sponsors/ioquatix/
   source_code_uri: https://github.com/socketry/agent-skills.git
@@ -54,7 +85,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.2'
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="