Developer Tooling UX Skill

SkillDev tools

Guides your agent to design and improve CLI commands, help text, error messages, and first-run experience.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Developer Tooling UX Skill skill

About this capability

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.

What this skill tells your AI

The instructions your AI receives, as published by microsoft/apm in .agents/skills/devx-ux/SKILL.md and read by ahel’s review.

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.

Signals

GitHub stars
4k
Forks
361
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
devx-ux
Source
github.com/microsoft/apm