devx-ux

Standardize CLI command surfaces, help text, and first-run flows across APM workflows.

3.5k|319|Updated Sep 18, 2025
One-click install
npx skills add https://github.com/microsoft/apm --skill devx-ux
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: devx-ux
Source: https://github.com/microsoft/apm/tree/main/.apm/skills/devx-ux
Command: npx skills add https://github.com/microsoft/apm --skill devx-ux

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Activates to guide design and modification of CLI command surfaces, help text, install/init/run flows, error wording, and first-run experiences in the APM CLI, ensuring a consistent and user-focused developer experience even when UX is not explicitly mentioned.

Core Features & Use Cases

  • Activation guidance for changes to CLI commands, flags, subcommands, and docstrings
  • Standardized messaging and prompts across init, install, run, compile, preview, and list workflows
  • Real-world scenarios include updating help text after a new command or adjusting error messages after a failed flow

Quick Start

Review and align your CLI UX guidelines by prompting the AI to audit current command surfaces, help content, and first-run prompts.

Frequently Asked Questions about devx-ux

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I standardize CLI error messaging and command help text?

To standardize CLI error messaging and command help text, apply consistent human-facing wording and behavior across all command surfaces, flags, and subcommands. This ensures a unified developer experience during init, install, run, and compile workflows.

What is the best way to design first-run CLI experiences for developers?

Designing first-run CLI experiences requires standardized prompts and messaging guidelines that govern user flows during initialization. This ensures intuitive command design and a seamless setup process for developer tooling.

How do I audit existing CLI command surfaces for UX consistency?

You can audit CLI command surfaces for UX consistency by prompting an AI to review current commands, help content, and first-run prompts. This identifies inconsistencies in human-facing wording across workflows like list and deps.

Does this approach support CLI commands for install, compile, and preview workflows?

Yes, this approach supports CLI commands for install, compile, and preview workflows by providing activation criteria and standardized messaging guidelines. It ensures consistent behavior and wording across all specified APM CLI operations.

When should I update CLI command docstrings and flags for user experience?

You should update CLI command docstrings and flags for user experience whenever changes are made to CLI code or command definitions. This maintains consistent human-facing wording and intuitive user flows across the tooling.