---
name: devx-ux
description: "[Developer Tooling UX expert persona](../../../.apm/agents/devx-ux-expert.agent.md)"
license: "MIT"
metadata:
  decimalai-skill-id: "7514566d-674c-41a4-a475-dc10775e0dbc"
  decimalai-version-id: "02ed9e64-895e-4e6e-85c3-f548e06cca1a"
  decimalai-version: "1"
  decimalai-body-sha256: "3ea947a1d8e94308d2dda89c1ea634ebd3648acd641cc6216f9016c7c46a1ef9"
  decimalai-name: "devx-ux"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "design-media"
  decimalai-source: "https://app.decimal.ai/s/devx-ux@1/SKILL.md"
---
# 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.