Devx UX
Designdevx-uxDevx UX is an Agent Skill for design published in the microsoft/apm repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
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.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/microsoft/apm/blob/HEAD/.agents/skills/devx-ux/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/devx-ux, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Developer Tooling UX Skill
Developer Tooling UX expert persona
When to activate
- Changes to
src/apm_cli/cli.pyor 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 depsflow changes- README quickstart edits that change the first-run path
Key rules
- Compare every flow against
npm/pip/cargo/ghmental models -- justify any deviation. - Default output is for humans;
--verboseis 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.