Skip to main content

bundles

AI Agent Skill bundles: named, reusable sets of skills. A bundle is a small manifest that references existing skills by name and is itself selectable as one unit. It is composition over the existing skills layer — not a new execution primitive. A bundle expands to its member skills, which then flow through the unchanged budget + prompt-injection path. Bundles are discovered alongside skills:
  • a top-level BUNDLE.yaml / BUNDLE.yml inside a skill directory, or
  • any *.yaml / *.yml file inside a bundles/ subdirectory of a skill root.
Selection uses a @ marker everywhere a skill is selected (skills=["@backend-dev"]), mirroring how skills already behave: forgiving membership, precedence-with-logging, and budget-awareness.

Import

Classes

BundleManifest

A named set of skills selectable as one unit.

Functions

strip_bundle_marker()

Return the bundle name for a @name selector (or the name itself).

is_bundle_selector()

True if selector is a @bundle reference.

discover_bundles()

Discover bundle manifests alongside skills.

Constants