GitHub Build or Reuse v1.2.2
v1.2.2 — Agent Plugins 1.0 compatibility without breaking skills.sh
This patch release makes Agent Plugins 1.0 a first-class distribution contract while preserving the existing Agent Skills and skills.sh installation paths.
What changed
- Added an explicit architecture decision that
skills/github-build-or-reuse/SKILL.mdremains the single canonical runtime source for Agent Plugins, Agent Skills and skills.sh consumers. - Added
scripts/validate-agent-plugin.pyto verify the portableplugin.json, fixedskills/discovery, version alignment, generated adapters, and exact parity with skills registered inskills.sh.json. - CI now runs the Agent Plugin / skills.sh coexistence validator in addition to the existing Agent Skills reference validation and
npx skills@latest add . --listdiscovery smoke test. - Added a compatibility evidence matrix that distinguishes conformance/manifest compatibility, install/discovery verification, and actual runtime verification.
- Documented the deliberate decision not to bundle a bespoke GitHub MCP server without a demonstrated capability gap.
- Added
agent-pluginsto distribution discovery metadata and regenerated affected manifests.
skills.sh compatibility
This release deliberately keeps all stable skills.sh inputs unchanged:
- repository:
ghspain/github-build-or-reuse; - skill:
github-build-or-reuse; - path:
skills/github-build-or-reuse/SKILL.md; - registration:
skills.sh.jsonstill includesgithub-build-or-reuse.
The new validator fails if the Agent Plugins-discovered skill set diverges from the skills.sh registration, providing a regression guard against future packaging changes accidentally dropping the skill from the existing ecosystem.
External skills.sh indexing/ranking remains outside repository control, so it is not made a brittle blocking CI dependency. The repository instead preserves and tests the stable discovery inputs under its control.
Runtime behavior
There is no change to the USE / CONTRIBUTE / FORK / BUILD decision model or to the skill's activation and evidence rules. This is a packaging, governance and compatibility hardening release.
Install
Existing installation remains valid:
npx skills@latest add ghspain/github-build-or-reuse --skill github-build-or-reuseOr with supporting GitHub CLI versions:
gh skill install ghspain/github-build-or-reuse github-build-or-reuse@v1.2.2