Skip to content

Component selection

The core pack labels components as required, recommended, or optional. Categories can contain skills, subagents, and instructions. Your final selection is stored as explicit component IDs.

--components recommended

Installs every required and currently recommended component. This is the best starting point for most users.

Choosing Recommended in the interactive menu also offers optional categories and individual components, with none preselected. Leave that selection empty to keep the baseline. Passing --components recommended explicitly skips this additional menu.

--components all

Installs every compatible component in the current pack version.

“All” is a one-time expansion, not a subscription. A new optional component published later is not silently installed.

For a small tailored setup:

--components ap-debug,ap-code-reviewer,ap-frontend-design

Required components are added automatically even if you do not list them.

Choose Custom during interactive agents-pack init. The menu groups compatible components by category, with recommended components preselected. Use the arrow keys to move, Space to toggle a whole category or individual component, and Enter to accept.

Required components are always included outside the editable selection. Each item shows its type, ID, selection level, and short description.

  • Your component IDs are stored explicitly.
  • If a component later changes from optional to recommended, it is not automatically added to an existing installation.
  • A newly required component may be added during an update. Required status is reserved for core management behavior.
  • Interactive updates offer newly introduced compatible components by category or individually. Nothing is preselected; existing choices stay intact.
  • update --yes skips the menu. Use update --add <id,id> for explicit additions, or install after updating.
  • Previously declined components are not offered again as new. Category choices are a one-time selection, not a subscription to future additions.
  • Required components cannot be removed.
agents-pack list
agents-pack list --installed
agents-pack list --available
agents-pack list --kind skill
agents-pack list --available --kind subagent

--installed and --available cannot be combined.