OpenParable
Skip to content
← Back to skills

Devx UX

Design
devx-ux

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

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. 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.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.