---
name: Developer Tooling UX
slug: developer-tooling-ux
category: Frontend
description: Developer Tooling UX guides the design of APM CLI command surfaces, help text, install/init/run flows, error wording, and first-run experience. Activate when modifying Click command definitions, help strings, error messages, or README quickstart paths.
github: "https://github.com/microsoft/apm/tree/main/.agents/skills/devx-ux"
language: Python
stars: 3544
forks: 324
install: "npx degit https://github.com/microsoft/apm/tree/main/.agents/skills/devx-ux ~/.claude/skills/devx-ux"
installs_to: ~/.claude/skills/devx-ux
source_path: .agents/skills/devx-ux/SKILL.md
collection_size: 21
category_size: 567
collection_url: "https://dirskills.com/collections/microsoft/apm"
added: 2026-08-16T07:02:24.952Z
last_synced: 2026-08-16T07:02:24.952Z
canonical_url: "https://dirskills.com/skills/developer-tooling-ux"
---

# Developer Tooling UX

Developer Tooling UX guides the design of APM CLI command surfaces, help text, install/init/run flows, error wording, and first-run experience. Activate when modifying Click command definitions, help strings, error messages, or README quickstart paths.

**Install:**

```bash
npx degit https://github.com/microsoft/apm/tree/main/.agents/skills/devx-ux ~/.claude/skills/devx-ux
```

## README

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