Pack contents
What is a Valdr pack?
A Valdr pack is a portable bundle of agent definitions, reusable instructions, and optional workflows or user tools. Importing a pack adds its contents to your local workspace.
Contents
| Content | Purpose |
|---|---|
| Pack manifest | Names the pack, records its version, and selects the source directories to include |
| Agent definitions | Declare handles, roles, and capability or prompt bindings |
| Capabilities and prompts | Supply reusable instructions and operating rules |
| Workflow definitions | Describe processes with inputs, steps, and results |
| User tools | Package programs and CLI adapters for workflow steps |
Agents can include orchestrators, planners, executors, reviewers, auditors, and language-specific starters. Providers and presets control how they run; see Providers & Presets.
Use a pack
Download an official archive from Valdr Packs releases. In Settings > Valdr Packs, upload it, review the preflight action plan, resolve conflicts, and commit the import. You can then use the imported agents and workflows without authoring pack files.
Follow Configure Valdr for official pack prerequisites and import order.
Import does not execute user tools. Review their code and requirements before running workflow steps that use them.
Author or update a pack
Use the official pack source for examples. Edit the YAML and Markdown source, validate it, generate a .valdr-pack.tar.gz archive, then import and verify the result. Make later changes in source and regenerate the archive.
Next step
Choose from What comes with Valdr, or follow the Authoring workflow for source locations, commands, and import steps.