46 lines
1.6 KiB
Markdown
46 lines
1.6 KiB
Markdown
# 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).
|