apm-usage

APM (Agent Package Manager) is the open-source package manager for AI coding agents. It lets teams install, share, and govern reusable instructions, prompts, agents, skills, and MCP server configurations across projects.

microsoft/apm4 installsMITSynced Aug 25

Works with

Claude CodeCursorCodex CLIGitHub CopilotGemini CLI

Agent Skills format with YAML frontmatter. Claude Code reads it as-is.

---
name: "apm-usage"
description: "APM (Agent Package Manager) is the open-source package manager for AI coding agents. It lets teams install, share, and govern reusable instructions, prompts, agents, skills, and MCP server configurations across projects."
license: "MIT"
---

# APM Usage

APM (Agent Package Manager) is the open-source package manager for AI coding
agents. It lets teams install, share, and govern reusable instructions, prompts,
agents, skills, and MCP server configurations across projects.

## When to activate

- User mentions `apm` or "Agent Package Manager"
- Questions about installing or managing AI-agent packages
- Setting up instructions, prompts, agents, skills, or chatmodes
- Configuring MCP servers through apm.yml
- Authentication for private repos (GitHub, ADO, GHES, Artifactory)
- Policy enforcement or `apm audit`
- Package authoring or publishing
- Compiling agent context (`apm compile`)
- Troubleshooting apm errors

## Key rules

- **Commit these files:** apm.yml, apm.lock.yaml, .apm/, deployed harness directories including .grok/, and AGENTS.md
- **Never commit:** apm_modules/ (add to .gitignore)
- **Team sync:** after `git clone`, run `apm install` to restore dependencies
- **Update deps:** `apm install --update` refreshes to latest refs
- **Pin versions:** use tags (`#v1.0.0`) in production, branches for development
- **ASCII only:** all CLI output and source must stay within printable ASCII

## Reference

For detailed guidance, see the following resources:

- [Installation](./installation.md) -- install and update APM
- [Workflow](./workflow.md) -- core workflow, apm.yml format, what to commit
- [Commands](./commands.md) -- full CLI command reference
- [Dependencies](./dependencies.md) -- all dependency formats and version pinning
- [Authentication](./authentication.md) -- token setup for private repos
- [Governance](./governance.md) -- policy engine and audit checks
- [Package Authoring](./package-authoring.md) -- creating APM packages
- [Troubleshooting](./troubleshooting.md) -- common errors and fixes

More General & Other skills

← All General & Other skills

Check your AI visibility

One URL in, a 0–100 score and the exact fixes out.

RUN THE CHECK

Browse all the tools

15 tools across six categories
13 of them never send your data anywhere

Free · No signup · No trial clock

SEE THE DIRECTORY