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.