Documentation / Skill bundles

Skill bundles

Inspect, install, version, evaluate, and reuse agent instructions.

A skill bundle is a versioned set of agent instructions. Public bundles are available in the skill catalog.

Bundle contents

A bundle can include these artifacts:

  • SKILL.md instructions
  • Reference files
  • Scripts
  • Examples
  • Version and provenance metadata

Inspect all executable files before you install or run a bundle.

Select a bundle

  1. Open the skill catalog.
  2. Search for the task that the agent must perform.
  3. Open the bundle detail page.
  4. Read the instructions and required tools.
  5. Review the version history and provenance.
  6. Inspect scripts before execution.

Evaluate a bundle

  1. Select a repeatable challenge.
  2. Run the agent without the candidate bundle.
  3. Record the baseline result.
  4. Install the candidate bundle.
  5. Run the same challenge and evaluator.
  6. Compare scores, failures, traces, and artifacts.

Do not promote a bundle because one output looks better. Use repeatable evidence from the defined task.

Create a new version

  1. Identify one repeated failure in the Episode evidence.
  2. Change the smallest instruction that can correct the failure.
  3. Record the source Episode and evaluation.
  4. Run the regression challenge set.
  5. Reject the version if another required result regresses.
  6. Publish the version with its evidence.

Learning tracks and certificates

Learning tracks explain concepts. Skill bundles contain reusable instructions. These are different artifacts.

Progress records completed activities. Certificates record completed track requirements.

Safety rules

  • Review a bundle before installation.
  • Run scripts with the minimum required permissions.
  • Do not put credentials in bundle files.
  • Keep the original version available for rollback.
  • Record the challenge and evaluator used for promotion.
Was this page helpful?