devx-ux

Activate when designing or modifying CLI command surfaces, command help text, install/init/run flows, error wording, or first-run experience in the APM CLI -- even when the user does not say "UX" explicitly.

Jump to install

Repository: microsoft/apm
Last source activity: April 21, 2026 at 22:09
Detected SKILL.md language: English
Stars: 3,549
Forks: 325

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/microsoft/apm --skill devx-ux

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

apm-usage

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.

2026-08-16

apm-spec-guardian

Use this skill to run a four-panel adversarial advisory review on any pull request that touches the OpenAPM specification artifact (docs/src/content/docs/specs/openapm-*.md), its inline / sidecar JSON Schemas (docs/src/content/docs/specs/schemas/*.schema.json), or the conformance fixture seed (tests/fixtures/spec-conformance/**). The panel fans out to four spec-ecosystem reviewers (swagger-openapi-editor, oci-distribution-editor, pkgmgr-registry-contract-editor, w3c-tag-architect), each running in its own agent thread, and a spec-editor synthesizer that produces a fold-now / defer-v0.1.1 / defer-v0.2 / reject list plus a ship decision keyed off a 1..10 shocked_meter scale. The orchestrator is the sole writer to the PR: ONE consolidated comment, no verdict labels, no merge gating. The panel is advisory -- it surfaces findings, prioritizes folds, and renders a ship recommendation that the maintainer weighs.

2026-07-31

apm-spec-guardian

2026-07-31

View all from this repository

name	devx-ux
description	Activate when designing or modifying CLI command surfaces, command help text, install/init/run flows, error wording, or first-run experience in the APM CLI -- even when the user does not say "UX" explicitly.

Developer Tooling UX Skill

Developer Tooling UX expert persona

When to activate

Changes to src/apm_cli/cli.py or any Click command definition
New / renamed commands, subcommands, flags, or positional args
Help strings (help=) and command docstrings
Error messages that the user reads (not internal exceptions)
apm init, apm install, apm run, apm compile, apm preview, apm list, apm deps flow changes
README quickstart edits that change the first-run path

Key rules

Compare every flow against npm / pip / cargo / gh mental models -- justify any deviation.
Default output is for humans; --verbose is for agents.
Every error names the failure, the cause, and one next action.
Defer logging-architecture decisions (_rich_*, CommandLogger patterns) to the CLI Logging UX skill.

devx-ux

Source facts

Install options

Review the source files

More from this repository

Developer Tooling UX Skill

When to activate

Key rules

Developer Tooling UX Skill

When to activate

Key rules

More from this repository