Skill2.9k repo starsupdated yesterday

devx-ux

The devx-ux skill reviews changes to CLI command structures, help text, error messages, and user-facing flows in the APM tool. Activate it when modifying Click command definitions, flags, arguments, or the initialization and primary command paths, ensuring consistency with established developer tool conventions like npm and cargo.

View source Repository: apm

Install in Claude Code

Copy

git clone --depth 1 https://github.com/microsoft/apm /tmp/devx-ux && cp -r /tmp/devx-ux/.apm/skills/devx-ux ~/.claude/skills/devx-ux

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# Developer Tooling UX Skill

[Developer Tooling UX expert persona](../../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.