speckit-bundle

name	speckit-bundle
description	Discover, install, and author Spec Kit bundles via `specify bundle`. USE FOR: searching/showing/listing bundles, installing/updating/removing a bundle (a curated set of extensions/presets/integrations/workflows), validating a bundle manifest, building a distributable bundle artifact, initializing a project and installing a bundle, managing bundle catalog sources. DO NOT USE FOR: individual extensions/presets/integrations/workflows (use their respective skills).
argument-hint	<search|info|list|install|update|remove|validate|build|init|catalog> [bundle id or path]

Spec Kit — bundles

Discover, install, and author Spec Kit bundles with the Specify CLI specify bundle command group. A bundle is a versioned, curated set of components (extensions, presets, integrations, workflows) installed together through each primitive's own machinery. (Requires Specify CLI >= 0.11.)

Prerequisite: needs the specify CLI. If specify --version fails, install it with the speckit-cli-setup skill first.

When to use

• Find and install a bundle, or update/remove an installed one.
• Author a bundle: validate its manifest and build a distributable artifact.
• Initialize a project and install a bundle in one step.

How to invoke

# Discover
specify bundle search <query>
specify bundle info <bundle-id>        # full metadata + fully expanded component set
specify bundle list                    # bundles installed in this project

# Install / update / remove
specify bundle install <bundle-id-or-path>     # catalog id, .zip, dir, or bundle.yml
specify bundle install <bundle-id> --integration <key> --offline
specify bundle update <bundle-id>
specify bundle remove <bundle-id>      # removes only what this bundle contributed

# Initialize a project, then optionally install a bundle
specify bundle init [<bundle-id>] [--integration <key>] [--offline]

# Authoring
specify bundle validate                # manifest well-formed + references resolve
specify bundle build --path <dir> --output <dir>   # produce a versioned .zip

# Catalog sources
specify bundle catalog list
specify bundle catalog add <url> [--policy install-allowed|discovery-only] [--priority <n>] [--id <id>]
specify bundle catalog remove <id>

Notes

• install accepts a catalog bundle id or a local path to a .zip, a bundle directory, or a bundle.yml.
• remove only uninstalls components the bundle contributed — no collateral removals.
• Use --offline to avoid network access when installing from local artifacts.
• For authoring, run specify bundle validate before specify bundle build.
• A bundle installs its components through each primitive's own machinery, so any extension/command components scaffold Copilot skills under .github/skills/ (in a skills-mode project). Run /skills reload to pick those up in the current session, or they load on the next session start.