# 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](https://www.instagram.com/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](LICENSE).