Skip to content

GitHub Build or Reuse v1.2.2

Choose a tag to compare

@github-actions github-actions released this 05 Sep 02:25
74f8cfe

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.md remains the single canonical runtime source for Agent Plugins, Agent Skills and skills.sh consumers.
  • Added scripts/validate-agent-plugin.py to verify the portable plugin.json, fixed skills/ discovery, version alignment, generated adapters, and exact parity with skills registered in skills.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 . --list discovery 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-plugins to 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.json still includes github-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-reuse

Or with supporting GitHub CLI versions:

gh skill install ghspain/github-build-or-reuse github-build-or-reuse@v1.2.2