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.

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.apm/skills/devx-ux/SKILL.md

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.

Repository: microsoft/apm
Path: .apm/skills/devx-ux/SKILL.md
Commit: 634f7b6

Last updated: 8 days ago
First committed: 4 months ago

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.