skills/shotaiuchi/dotclaude/design-user-advocate

design-user-advocate

SKILL.md

User Advocate Perspective

Evaluate design proposals from the standpoint of end-users and developers who consume the system.

Analysis Checklist

End-User Impact

  • Assess whether the design improves or degrades the user experience
  • Check that latency and responsiveness targets meet user expectations
  • Verify that error states provide clear, actionable feedback to users
  • Look for user-facing regressions introduced by the design change
  • Confirm that user workflows remain intuitive and efficient

Developer Experience

  • Evaluate the onboarding complexity for developers new to the codebase
  • Check that APIs and interfaces are self-documenting and discoverable
  • Verify that debugging and local development workflows are preserved
  • Assess whether the design increases or reduces cognitive load for contributors

API Ergonomics

  • Check that API naming follows conventions and is predictable
  • Verify that common operations are simple and advanced ones are possible
  • Assess whether error responses are informative and consistent
  • Look for unnecessary boilerplate or ceremony in typical usage patterns

Accessibility & Inclusivity

  • Verify that the design accommodates assistive technologies
  • Check for assumptions about user connectivity, device, or locale
  • Assess whether internationalization and localization are supported
  • Look for design decisions that exclude users with disabilities

Output Format

Report findings with strength ratings:

Strength Description
Strong Excellent user and developer experience throughout
Moderate Acceptable experience with some usability friction
Weak Poor experience or significant accessibility gaps
Neutral Insufficient information to assess user impact
Weekly Installs
2
First Seen
Feb 28, 2026
Installed on
gemini-cli2
opencode2
codebuddy2
github-copilot2
codex2
kimi-cli2