agent-hub-release

Cut frozen-binary and npm sidecar releases for GAIA agents via tag-triggered CI pipelines.

1.6k|168|Updated Dec 16, 2024
One-click install
npx skills add https://github.com/amd/gaia --skill agent-hub-release-amd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-hub-release
Source: https://github.com/amd/gaia/tree/main/.claude/skills/agent-hub-release
Command: npx skills add https://github.com/amd/gaia --skill agent-hub-release-amd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Releasing a GAIA sidecar agent requires coordinating PyInstaller binary freezes across four platforms, immutable uploads to the Agent Hub Worker, SHA-256 lock generation, and npm OIDC publishing — a multi-stage process with irreversible steps that is easy to get wrong without a documented procedure. ## Core Features & Use Cases - Release execution: Walks through version synchronization across the git tag, npm package.json, and gaia-agent.yaml, then the tag-triggered build, human approval gate, and atomic publish stages. - New agent onboarding: Explains how to scaffold a new sidecar agent by mirroring the email agent's packaging scripts, npm client, and release_agent_<id>.yml workflow, including npm trusted publisher registration. - Infrastructure verification: Lists the one-time maintainer setup (agent-publish environment, GAIA_HUB_TOKEN secret, hub URL vars) that must exist before the first release. - Use Case: A maintainer bumps the email agent to a new version, tags agent-pkg-email-v1.2.0 from main, and uses this Skill to navigate the freeze, publish-gate approval, fetch-verify, and npm publish stages without corrupting the immutable Hub catalog. ## Quick Start Ask the assistant to cut a new sidecar release for the email agent at a specific version, or to onboard a new agent under hub/agents/ with its own release workflow.

Frequently Asked Questions about agent-hub-release

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I release a GAIA sidecar agent to the Agent Hub?

Bump the version with gaia agent version, sync the npm package.json manually, merge to main, then push a tag matching agent-pkg-<id>-v<version>. The CI workflow freezes binaries on four platforms, waits for approval on the agent-publish environment, then publishes to the Hub and npm.

How do I onboard a new sidecar agent with an npm client?

Scaffold the agent with gaia agent init, add packaging scripts and an npm client mirroring hub/agents/email, then copy release_agent_email.yml to release_agent_<id>.yml and update paths, tag trigger, and package names. Register the npm trusted publisher against the exact workflow filename.

Why does the release workflow fail on version validation?

The Resolve step requires three identical versions: the git tag, npm package.json, and gaia-agent.yaml. gaia agent version bumps only the Python side from the yaml value, so you must manually sync package.json before tagging.

Can I overwrite a published agent binary on the Agent Hub?

No, publishes are immutable per filename and the Worker returns 409 on re-POST. Identical bytes are treated as an idempotent no-op, but a hash mismatch fails loudly; fix a bad release by publishing a new version.

What happens if the darwin-x64 Intel build fails?

The Intel build is best-effort: if it fails, the release proceeds as a 3-platform release with a loud warning. Intel users receive a clear no-binary install error rather than a placeholder artifact.