experience-first

Prioritize consumer experience over implementation convenience in product and interface decisions.

2|Updated May 14, 2026
One-click install
npx skills add https://github.com/AnthonyPoschen/agent-skills --skill experience-first-anthonyposchen
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: experience-first
Source: https://github.com/AnthonyPoschen/agent-skills/tree/main/skills/experience-first
Command: npx skills add https://github.com/AnthonyPoschen/agent-skills --skill experience-first-anthonyposchen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often let implementation convenience drive product, UX, and API decisions, producing cluttered interfaces, confusing workflows, and experience debt that frustrates end users, library callers, and operators. ## Core Features & Use Cases - Core Workflow Focus: Identify who consumes a change and keep their path from start to successful outcome short, obvious, and trustworthy, including empty, error, and recovery states. - Scope Discipline: Force every feature, option, setting, and abstraction to earn its place by serving the core workflow, with sensible defaults replacing unnecessary decisions. - Experience-First Tradeoffs: Resolve conflicts between implementation convenience and user clarity in favor of the consumer, and review finished work with a five-question outside-in checklist. - Use Case: When designing a new settings page or library API, apply this Skill to cut unused controls, choose defaults, and ensure callers never need workarounds or guesswork. ## Quick Start Review this feature proposal with the experience-first skill and tell me what to remove, default, or simplify for the end user.

Frequently Asked Questions about experience-first

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

FAQPage Schema
How do I prioritize user experience over implementation convenience?▼

Identify who consumes the change and follow their path from start to successful outcome. When convenience conflicts with a clearer or more reliable experience, favor the experience within the bounds of correctness, safety, accessibility, and explicit requirements.

How to decide which features to cut from a product workflow?▼

Require every feature, control, option, and configuration point to help the consumer complete the core workflow. Remove, defer, or simplify anything that does not, and prefer a few complete polished workflows over many partial ones.

What is experience debt in API and interface design?▼

Experience debt occurs when a library caller needs conversions, sequencing knowledge, or workarounds, or when a product user must guess, recover from silent failures, or navigate unused controls. Fix the owning shape when the problem is systemic.

When should I use defaults instead of exposing configuration options?▼

Choose sensible defaults when they remove a decision without hiding a meaningful tradeoff. Keep lower-level control only where consumers have a real, demonstrated need for it rather than exposing generic flexibility.

When is the experience-first approach not the right priority?▼

Experience does not override correctness, safety, accessibility, or explicit requirements, which remain hard bounds. It also should not justify polishing a weak flow into permanence before removing friction and unused scope first.