# Devx UX

Activate when designing or modifying CLI command surfaces, command help text...

- Repository: https://github.com/microsoft/apm (4171 stars)
- Category: Design
- License: MIT
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add microsoft/apm --skill devx-ux -g -a claude-code -y`
Codex: `npx skills add microsoft/apm --skill devx-ux -g -a codex -y`
Cursor: `npx skills add microsoft/apm --skill devx-ux -g -a cursor -y`
Gemini CLI: `npx skills add microsoft/apm --skill devx-ux -g -a gemini-cli -y`

## 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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Developer Tooling UX Skill

[Developer Tooling UX expert persona](../../../.apm/agents/devx-ux-expert.agent.md)

## 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.