
apm-usage
โ Officialโ 3,123by microsoft ยท part of microsoft/apm
Activate when the user asks about APM (Agent Package Manager): installing, configuring, authoring, or troubleshooting AI-agent packages, dependencies, compilation, MCP servers, policy, or any `apm` CLI command.
This is the playbook your agent receives when the skill activates โ you don't need to read it to use the skill, but it's here to audit before installing.
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
apmor "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, runapm installto restore dependencies - Update deps:
apm install --updaterefreshes 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 -- install and update APM
- Workflow -- core workflow, apm.yml format, what to commit
- Commands -- full CLI command reference
- Dependencies -- all dependency formats and version pinning
- Authentication -- token setup for private repos
- Governance -- policy engine and audit checks
- Package Authoring -- creating APM packages
- Troubleshooting -- common errors and fixes
npx skills add microsoft/apm --skill "apm-usage" --full-depthRun this in your project โ your agent picks the skill up automatically.
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.
Licensed under MITโ you can use, modify, and redistribute it under that license's terms.
View the full license file on GitHub โ