Labsco
microsoft logo

devx-ux

✓ Official★ 3,100

by microsoft · part of microsoft/apm

Developer Tooling UX expert persona

🔥🔥FreeQuick setup
#git
🧰 Not standalone. This skill ships with microsoft/apm and only works together with that tool — install the tool first, then add this skill.

This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.

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.