Initial commit

README.md

@@ -0,0 +1,45 @@
+# 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).