Praison AI

bundles • AI Agent SDK

Skill bundles: named, reusable sets of skills.

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

python
from praisonaiagents.skills import bundles

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

NameValue
BUNDLE_MARKER'@'