Skip to content

Releases

v1.0.0

v1.0.0 Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 10 Nov 23:17
v1.0.0
5495bb5

Added

  • A standalone, MIT-licensed repository for the swarm skill. Install it with npx skills
    (skills.sh), the Claude Code plugin marketplace, the Codex plugin marketplace, or pi install.
  • Release assets: swarm-skill.zip, which passes the strict Agent Skills spec (claude.ai, Cowork,
    Claude Skills API, or unzipped into any agent's skills folder), and swarm-plugin.zip, which carries the Agent Plugins,
    Claude Code and Codex manifests (OpenAI plugin portal, Codex desktop, claude --plugin-url).
    Both zips are deterministic, and the release lists them in SHA256SUMS with build provenance.
  • Codex: agents/openai.yaml, with allow_implicit_invocation: false. The plugin also sets
    requires_local_executor.
  • swarm skills searches the Agent Skills locations (.agents/skills, ~/.agents/skills,
    ~/.config/agents/skills), pi's and Codex's folders, and project folders from cwd up to the repo
    root. It follows the symlinks npx skills creates, lists each skill once, and names plugin skills
    from Agent Plugins and Codex manifests too.
  • swarm audit flags access to ~/.codex/.
  • Unit and integration tests for the workbench, with a stub pi for spawn. A validator for the
    spec, every manifest and OpenAI's listing limits. One generator for all manifests.

Changed

  • disable-model-invocation is now a top-level SKILL.md field, so Claude Code and pi honour it.
    As metadata.disable-model-invocation it had no effect.
  • allowed-tools is space-separated, as the spec asks. schema.sql moved to assets/.
  • SKILL.md no longer assumes one company's stack. Worktree setup, network hosts and lead-only
    work (specs, the live app, the final review) are now written for any repo. The concrete pnpm +
    submodules + in-memory MongoDB setup moved to references/worktree-setup.md as a worked example.

Install

Where How
Any agent (skills.sh) npx skills add marcopesani/swarm-skill
Claude Code /plugin install swarm --marketplace marcopesani/swarm-skill
Claude Code, this exact build claude --plugin-url https://github.com/marcopesani/swarm-skill/releases/download/v1.0.0/swarm-plugin.zip
Codex CLI / app codex plugin marketplace add marcopesani/swarm-skill, then codex plugin add swarm@swarm-skill
pi pi install git:github.com/marcopesani/swarm-skill@v1.0.0
claude.ai, Cowork, Claude Skills API upload swarm-skill.zip
Codex / ChatGPT desktop, any agent, by hand unzip swarm-skill.zip into ~/.agents/skills/ (or your agent's skills folder)
OpenAI plugin portal, Codex desktop (manual) upload or unpack swarm-plugin.zip

Assets

  • swarm-skill.zip: the skill alone (swarm/SKILL.md at the top), limited to the six Agent Skills frontmatter fields.
  • swarm-plugin.zip: the plugin, with plugin.json (Agent Plugins, OpenAI), .claude-plugin/plugin.json and .codex-plugin/plugin.json at the top and skills/swarm/ beside them.
  • SHA256SUMS: checksums. The zips are reproducible: npm ci && npm run package at tag v1.0.0 on Node.js 24 rebuilds the same bytes.

Verify a download:

sha256sum -c SHA256SUMS --ignore-missing
gh attestation verify swarm-plugin.zip --repo marcopesani/swarm-skill
Assets 5
Loading