Component selection
Component selection
Section titled “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.
Recommended
Section titled “Recommended”--components recommendedInstalls 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 allInstalls 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.
Explicit component IDs
Section titled “Explicit component IDs”For a small tailored setup:
--components ap-debug,ap-code-reviewer,ap-frontend-designRequired components are added automatically even if you do not list them.
Custom interactive selection
Section titled “Custom interactive selection”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.
What selection means after init
Section titled “What selection means after init”- 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 --yesskips the menu. Useupdate --add <id,id>for explicit additions, orinstallafter 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.
Browse what you have
Section titled “Browse what you have”agents-pack listagents-pack list --installedagents-pack list --availableagents-pack list --kind skillagents-pack list --available --kind subagent--installed and --available cannot be combined.