Devx UX

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.

mvanhorn 172e7b8 1.1 KB Updated

File contents

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.

mvanhorn/apm/tree/main/.github/skills/devx-ux commit 172e7b8d66

Frequently asked questions

npx skillmds@latest add mvanhorn/devx-ux