Note: This marketplace content is maintained as static pages in the handbook (Phase 1). Per Decision 13, the handbook will eventually be a CI-driven consumer of generated catalog data from apm-registry releases.
APM Marketplace
The APM Marketplace is the staff-facing portal for Calab.ai APM packages and agent primitives. All content is generated from catalog artifacts published by calab-ai/apm-registry.
Handbook is a consumer, not the source of truth. Package manifests and primitive source files live in calab-ai/apm-registry. This handbook renders the generated catalog; it does not own or duplicate registry data. See Decision 13 for the decision rationale.
Marketplace pages are synced from the
calab-ai/apm-registryrelease catalog artifact by thecalab-sync-agent-primitives-botGitHub App. The app opens PRs tocalab-ai/calab-handbookforcontent/03 Products/Agent Primitives/marketplace/**; it never pushes directly tomain, and normal handbook CI gates apply. The.github-privatesync remains a parallel distribution target for generated org-level agent files.
Catalog Snapshot
| Field | Value |
|---|---|
| Registry | calab-ai/apm-registry |
| Catalog version | 1.0.0 |
| Generated at | 04/26/2026 02:21:13 |
Packages
Packages are curated compositions of primitives for specific use cases. Install a package to get all its primitives in one step.
| Package | Version | Lifecycle | Owner | Description |
|---|---|---|---|---|
| calab-org-agents | 1.0.0 | GA | calab-ai | Org-level Copilot agent package. Composes the build and plan agents for distribution to calab-ai/.github-private via the APM release pipeline. |
| calab-workspace-base | 1.0.0 | GA | calab-ai | Base workspace package for Calab AI consumer repositories. Installs the core build and plan agents, shared coding-standards and security instructions, and essential CLI skills. |
Primitives
Primitives are the individual building blocks. They can be installed standalone or as part of a package.
Agent
| Name | Version | Lifecycle | Description |
|---|---|---|---|
| build | 1.0.0 | GA | You action and complete tasks. |
| plan | 1.0.0 | GA | You plan, decompose, and sequence work before acting. |
Instructions
| Name | Version | Lifecycle | Description |
|---|---|---|---|
| coding-standards | 1.0.0 | GA | – |
| security | 1.0.0 | GA | – |
Skill
| Name | Version | Lifecycle | Description |
|---|---|---|---|
| az-cli | 1.0.0 | GA | – |
| export-to-pdf | 1.0.0 | GA | – |
| gh-cli | 1.0.0 | GA | – |
| repo-calab-handbook | 1.0.0 | GA | – |
| repo-github-private | 1.0.0 | GA | – |
| summarise | 1.0.0 | GA | – |
| todo-cli | 1.0.0 | GA | – |
How To Install
Use the gh calab CLI to install packages or primitives into your repository:
# Install a full package
gh calab apm install calab-workspace-base
# Resolve and lock all declared dependencies
gh calab apm resolve
# Check for drift between lockfile and installed files
gh calab apm validateDeclare dependencies in apm.yml in your repository root:
dependencies:
- id: calab.package.workspace-base
source:
repo: calab-ai/apm-registry
ref: refs/tags/packages/calab-workspace-base/v1.0.0
targets:
- path: .github/copilot