Building Good UX Skill

This repository packages the same building-good-ux skill for three different agent ecosystems.

It repurposes the existing multi-harness packaging into a reusable UX skill grounded in:

• general UX best practices,
• and real-world product patterns.

It is inspired by the "Building Good UX" series by synsation.

Contents

• Intent.md: the canonical behavior spec for the skill
• codex/building-good-ux: Codex-formatted package
• claude/building-good-ux: Claude Code-formatted package
• openclaw/building-good-ux: OpenClaw-formatted package
• copy-script/: Python installer and its README

What The Skill Does

building-good-ux helps an agent improve product experience quality instead of focusing only on the happy path.

It is designed to help with:

• loading, empty, error, partial, and success states,
• form friction and inline validation,
• error copy and error placement,
• graceful degradation and local recovery,
• and practical UX recommendations tied to real interface behavior.

Repo Layout

• Intent.md is the source of truth for shared skill behavior
• each package folder contains an installable SKILL.md and a short ecosystem README
• copy-script/README.md explains how to install the packaged skill folders
• CI spellchecks Markdown with the project dictionary from cspell.json

Installation

Run the Python installer in copy-script/ to copy the package folders into the matching skills directories under your home folder.

License

This repository is licensed under the MIT License. See LICENSE.