Skip to content

ship-agent-skill

skillLast commit

End-to-end Codex and Claude Code skill for validating, packaging, publishing, releasing, and verifying portable Agent Skills.

Open productSource
Role
Agent workflow design and automation engineering
Scope
Agent workflow, validation automation, and packaging
Status
Published npm package

Problem

Releasing a skill spans mutable local state and several independent remote systems, making partial success, version drift, and accidental publication easy.

Constraints

  1. C1

    Publishing, pushing, releases, deployment, and catalog changes need separate authorization.

  2. C2

    Codex and Claude Code require different install destinations but one portable payload.

  3. C3

    An immutable artifact may already exist when a later stage fails.

Architecture

Agent-facing orchestration in SKILL.md; deterministic preflight/release-gate references; npm installer/package contract and consumer-side tests.

01

Skill workflow

Agent-facing orchestration in SKILL.md.

02

Automation

Deterministic preflight/release-gate references.

03

Verification

Npm installer/package contract and consumer-side tests.

Decisions

D1

Model release stages separately

Model release stages separately rather than treating "ship" as blanket permission.

D2

Validate host portability before creating immutable artifacts

Validate host portability before creating immutable artifacts.

D3

Verify the installed consumer view after registry/release checks

Verify the installed consumer view after registry/release checks, accepting more gates for stronger end-to-end evidence.

Contribution

  • Defined an authorization-aware release inventory and workflow.
  • Built deterministic preflight checks.
  • Implemented safe dual-host installation with path/symlink/rollback protections.
  • Tested dry runs, replacement, package contents, and consumer contracts.

Outcomes

  • Agents can prepare without publishing.
  • Execute only authorized stages.
  • Distinguish partial remote success.
  • Verify tag, GitHub release, npm package, install command, and catalog state from the consumer side.

Verified stack

  • Agent Skills
  • JavaScript
  • Node.js
  • npm
  • GitHub Actions
  • CI/CD
  • Git

Working through something similar?

Share your challenge, scope, and timeline to start a focused conversation.