microsoft apm
OFFICIALLABSCO SUMMARY
Most of what we can read is maintainer process: an issue-to-merged-PR pipeline (apm-issue-autopilot, apm-triage-panel, batch-bug-shepherd, shepherd-driver), review panels for pull requests and spec changes (apm-review-panel, apm-spec-guardian, apm-strategy), a documentation-sync suite that checks whether docs still match the code (docs-corpus-audit, docs-impact-classifier, docs-impact-architect, docs-impact-localizer, docs-sync), and release and code-quality skills (cut-release, supply-chain-security, auth, cli-logging-ux, devx-ux, python-architecture, pr-description-skill, oss-growth). One skill, apm-usage, is different: it activates when a user asks how to install, configure, author, or troubleshoot APM itself.
This package is built for the small group of people who maintain the APM project. If you are installing APM to manage your own project's agent dependencies, apm-usage is the one skill of the twenty-seven aimed at you; the rest assume you have write access to microsoft/apm and are shepherding its own issues, releases, and documentation.
READ THE FULL ANALYSIS
Two of the twenty-seven are placeholders, not real skills. example-skill is described as an example skill from a mock plugin, and Test Skill as a test skill from a marketplace plugin — both read as fixtures for testing APM's own plugin-loading code, not something meant to be invoked on purpose.
We could not read every description. A few of the twenty-seven had no description in what we captured, so this summary is grounded in the ones we could actually read rather than a full accounting of all of them.
ALSO IN THIS PACKAGE
agentic workflows
GitHub Agentic Workflows (gh-aw) - Create, debug, and upgrade AI-powered workflows with intelligent prompt routing
apm-ceo
Strategic owner of microsoft/apm. OSS PM/CEO persona.
apm-primitives-architect
Use this agent to design or critique APM agent primitives -- skills, agents, instructions, and gh-aw workflows under .apm/ and .github/. Activate when authoring new primitives, refactoring existing skill bundles, designing multi-agent orchestration, or assessing whether a primitive change adheres to PROSE and Agent Skills best practices.
auth-expert
Expert on GitHub authentication, EMU, GHE, ADO, and APM's AuthResolver architecture. Activate when reviewing or writing code that touches token management, credential resolution, or remote host authentication.
cdo
APM Chief Documentation Officer. Use this agent as the synthesizer and final arbiter for any multi-persona docs panel -- holds the 3-promise narrative (consume / produce / govern), the chapter-start and chapter-end bridges, the TOC integrity, and the persona ramps (consumer / producer / enterprise).
cli-logging-expert
Expert on CLI output UX, CommandLogger patterns, and diagnostic rendering in APM. Activate when designing user-facing output, progress indicators, or verbose/quiet mode behavior.
devx-ux-expert
Developer Tooling UX expert specialized in package manager mental models (npm, pip, cargo, brew). Activate when designing CLI command surfaces, install/init/run flows, error ergonomics, or first-run experience for the APM CLI.
doc analyser
Describe what this custom agent does and when to use it.
doc writer
APM documentation writer. Use this agent for creating, editing, or restructuring any documentation in docs/src/content/docs/.
editorial owner
APM documentation editorial owner. Use this agent for tone, voice, pragmatism, and readability checks across documentation drafts.
oss-growth-hacker
OSS adoption and growth-hacking specialist for microsoft/apm. Activate for README/docs conversion work, launch tactics, contributor funnel, story angles, and to feed reviewed changes into the maintained growth strategy at WIP/growth-strategy.md.
performance-expert
Performance engineering specialist for package-manager workloads. Activate when reviewing or designing dependency resolution, lockfile schema, cache layout, parallel download phases, git transport, partial clones, filesystem materialization, or any code path that introduces algorithmic complexity regressions (O(n^2) loops, repeated I/O, missing indexes, unconditional full scans, blocking synchronous calls on hot paths, heavy top-level imports) in the APM CLI.
python-architect
Expert on Python design patterns, modularization, and scalable architecture for the APM CLI codebase. Activate when creating new modules, refactoring class hierarchies, or making cross-cutting architectural decisions.
spec-editor-synthesizer
Spec-editor synthesizer persona for the apm-spec-guardian skill. This is the same hand that drafts the OpenAPM specification artifact in new-version mode and that arbitrates panel returns in editorial-patch mode.
spec-oci-editor
Adversarial OCI distribution editor persona for reviewing the OpenAPM specification artifact. Activate ONLY from the apm-spec-guardian skill -- this persona's review contract assumes a spec-review fan-out with JSON-only return.
spec-pkgmgr-editor
Adversarial package-manager registry-contract editor persona for reviewing the OpenAPM specification artifact. Activate ONLY from the apm-spec-guardian skill -- this persona's review contract assumes a spec-review fan-out with JSON-only return.
spec-swagger-editor
Adversarial OpenAPI / Swagger editor persona for reviewing the OpenAPM specification artifact. Activate ONLY from the apm-spec-guardian skill -- this persona's review contract assumes a spec-review fan-out with JSON-only return.
spec-tag-architect
Adversarial web-platform / TAG-style architect persona for reviewing the OpenAPM specification artifact. Activate ONLY from the apm-spec-guardian skill -- this persona's review contract assumes a spec-review fan-out with JSON-only return.
supply-chain-security-expert
Supply-chain cybersecurity expert. Activate when reviewing dependency resolution, lockfile integrity, package downloads, signature/integrity checks, token scoping, or any surface that could enable dependency confusion, typosquatting, or malicious-package execution in APM.
test-coverage-expert
Test-coverage expert paired with the DevX UX lens. Activate when reviewing PRs that change CLI surface (commands, flags, help text), error wording, exit codes, install/init/run flows, lockfile behavior, auth resolution, hooks, marketplace, or any contract a user can observe -- even when the user does not say "tests" or "coverage".
agentic workflows
GitHub Agentic Workflows (gh-aw) - Create, debug, and upgrade AI-powered workflows with intelligent prompt routing
apm-ceo
Strategic owner of microsoft/apm. OSS PM/CEO persona.
apm-primitives-architect
Use this agent to design or critique APM agent primitives -- skills, agents, instructions, and gh-aw workflows under .apm/ and .github/. Activate when authoring new primitives, refactoring existing skill bundles, designing multi-agent orchestration, or assessing whether a primitive change adheres to PROSE and Agent Skills best practices.
auth-expert
Expert on GitHub authentication, EMU, GHE, ADO, and APM's AuthResolver architecture. Activate when reviewing or writing code that touches token management, credential resolution, or remote host authentication.
cdo
APM Chief Documentation Officer. Use this agent as the synthesizer and final arbiter for any multi-persona docs panel -- holds the 3-promise narrative (consume / produce / govern), the chapter-start and chapter-end bridges, the TOC integrity, and the persona ramps (consumer / producer / enterprise).
cli-logging-expert
Expert on CLI output UX, CommandLogger patterns, and diagnostic rendering in APM. Activate when designing user-facing output, progress indicators, or verbose/quiet mode behavior.
devx-ux-expert
Developer Tooling UX expert specialized in package manager mental models (npm, pip, cargo, brew). Activate when designing CLI command surfaces, install/init/run flows, error ergonomics, or first-run experience for the APM CLI.
doc analyser
Describe what this custom agent does and when to use it.
doc writer
APM documentation writer. Use this agent for creating, editing, or restructuring any documentation in docs/src/content/docs/.
editorial owner
APM documentation editorial owner. Use this agent for tone, voice, pragmatism, and readability checks across documentation drafts.
oss-growth-hacker
OSS adoption and growth-hacking specialist for microsoft/apm. Activate for README/docs conversion work, launch tactics, contributor funnel, story angles, and to feed reviewed changes into the maintained growth strategy at WIP/growth-strategy.md.
performance-expert
Performance engineering specialist for package-manager workloads. Activate when reviewing or designing dependency resolution, lockfile schema, cache layout, parallel download phases, git transport, partial clones, filesystem materialization, or any code path that introduces algorithmic complexity regressions (O(n^2) loops, repeated I/O, missing indexes, unconditional full scans, blocking synchronous calls on hot paths, heavy top-level imports) in the APM CLI.
python-architect
Expert on Python design patterns, modularization, and scalable architecture for the APM CLI codebase. Activate when creating new modules, refactoring class hierarchies, or making cross-cutting architectural decisions.
spec-editor-synthesizer
Spec-editor synthesizer persona for the apm-spec-guardian skill. This is the same hand that drafts the OpenAPM specification artifact in new-version mode and that arbitrates panel returns in editorial-patch mode.
spec-oci-editor
Adversarial OCI distribution editor persona for reviewing the OpenAPM specification artifact. Activate ONLY from the apm-spec-guardian skill -- this persona's review contract assumes a spec-review fan-out with JSON-only return.
spec-pkgmgr-editor
Adversarial package-manager registry-contract editor persona for reviewing the OpenAPM specification artifact. Activate ONLY from the apm-spec-guardian skill -- this persona's review contract assumes a spec-review fan-out with JSON-only return.
spec-swagger-editor
Adversarial OpenAPI / Swagger editor persona for reviewing the OpenAPM specification artifact. Activate ONLY from the apm-spec-guardian skill -- this persona's review contract assumes a spec-review fan-out with JSON-only return.
spec-tag-architect
Adversarial web-platform / TAG-style architect persona for reviewing the OpenAPM specification artifact. Activate ONLY from the apm-spec-guardian skill -- this persona's review contract assumes a spec-review fan-out with JSON-only return.
supply-chain-security-expert
Supply-chain cybersecurity expert. Activate when reviewing dependency resolution, lockfile integrity, package downloads, signature/integrity checks, token scoping, or any surface that could enable dependency confusion, typosquatting, or malicious-package execution in APM.
test-coverage-expert
Test-coverage expert paired with the DevX UX lens. Activate when reviewing PRs that change CLI surface (commands, flags, help text), error wording, exit codes, install/init/run flows, lockfile behavior, auth resolution, hooks, marketplace, or any contract a user can observe -- even when the user does not say "tests" or "coverage".
apm-expert
Expert on APM (Agent Package Manager). Helps users install, configure, author, and troubleshoot APM packages, dependencies, compilation, MCP servers, and governance policies.
Autopilot Issue Delivery
Queue accepted issues and fan out isolated autopilot-issue-delivery-worker slots (default 2)
Autopilot Scheduler Issue Triage
Queue open issues and fan out isolated issue-triage-worker slots (default 2)
Autopilot PR Review
Queue PRs labelled panel-review or status/accepted and fan out isolated review slots (default 2)
Autopilot PR Triage
Queue open pull requests and fan out isolated PR-triage worker slots (default 2)
github
Official GitHub MCP server for repository search, issues, pull requests, code context, and GitHub workflows in MCP-compatible AI clients.
http · https://api.githubcopilot.com/mcp/WHAT'S INSIDE
22 showing · 22 totalNothing else to set up — install it and go.
{{project_name}}
apm-spec-guardian
An edit to the written OpenAPM standard gets picked apart by four reviewers who know how other technical standards are put together, and comes back sorted into take now, hold for a later version, or drop.
apm-strategy
Governs how the microsoft/apm project presents itself — its README, release notes, and issue templates — backs every claim with real GitHub numbers, and settles it when the project's specialist reviewers disagree.
apm-usage
APM is a package manager for AI coding assistants — a way to install and share reusable instructions across projects. This is the day-to-day help for it: setting a project up, adding and updating packages, and making sense of the errors.
auth
How APM proves who you are when it fetches packages from a private repository — where it looks for your access token, what it falls back to when that fails, and what the error message should say.
cli-logging-ux
Decides what APM prints in a terminal — whether a message earns its place at all, what colour it carries, and where in the output it belongs.
cut-release
Gets the next version of APM ready to go out — how big the version jump is, the list of changes tidied into a dated entry, the version files updated — and stops short of actually publishing it.
devx-ux
Keeps APM's commands feeling like the tools people already use — the names, the help text, the wording of errors, and what happens the very first time someone runs it.
docs-corpus-audit
Reads every page of APM's documentation against the code it describes, corrects the claims that have gone out of date, and gathers the corrections into one change for the maintainer to review.
docs-grounding-verifier
Breaks a documentation page into its individual factual statements and checks each one against the code, so you can see how much of the page is still true.
docs-impact-architect
When a change needs documentation that does not exist yet, this plans where the new pages go, what gets moved and what gets retired, and sketches an outline for each — somebody else writes the actual words.
docs-impact-classifier
Answers the cheap first question before anyone reviews documentation — whether a code change needs any doc work at all, and if it does, whether that means a paragraph or a whole new page.
docs-impact-localizer
The planning step between deciding that some documentation needs changing and actually writing it: which page, which section, which lines, and what needs checking first.
docs-sync
Every proposed code change gets checked for whether it quietly makes the documentation wrong, and when it does, a ready-to-paste fix arrives as one comment on that change.
example-skill
hello
oss-growth
Looks after the parts of an open-source project a newcomer meets first — the front page, the quickstart, the starter templates, the launch posts — and whether each one actually turns a visitor into a user.
placeholder
pr-description-skill
Writes the write-up that goes with a proposed code change — what problem it solves, how, what it gives up in exchange, and how to check it works — short enough that a reviewer reads all of it.
python-architecture
A check on changes big enough to alter the shape of the codebase — new modules, reworked class hierarchies, anything spanning several files — that they follow the patterns already there instead of inventing new ones.
supply-chain-security
Guards the point where APM downloads and installs somebody else's code — what may be written to disk, what may be deleted, how credentials are read, and when to refuse rather than carry on unverified.
Test Skill
HOW TO GET IT
npx skills add microsoft/apmnpx skills add microsoft/apm --skill <name> --full-depthPick the skill name from the Skills tab — each entry there installs independently.