# UX Acceptance Coordinator

Coordinate black-box, agent-driven UX acceptance journeys against a disposable EmDash...

- Repository: https://github.com/emdash-cms/emdash (14094 stars)
- Category: Design
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add emdash-cms/emdash --skill ux-acceptance-coordinator -g -a claude-code -y`
Codex: `npx skills add emdash-cms/emdash --skill ux-acceptance-coordinator -g -a codex -y`
Cursor: `npx skills add emdash-cms/emdash --skill ux-acceptance-coordinator -g -a cursor -y`
Gemini CLI: `npx skills add emdash-cms/emdash --skill ux-acceptance-coordinator -g -a gemini-cli -y`

## Description

Coordinate black-box, agent-driven UX acceptance journeys against a disposable EmDash admin site. Use when preparing, dispatching, verifying, or reporting a manual browser journey performed by a separate tester agent. Do not use for deterministic Playwright tests or ordinary code review.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Coordinate UX acceptance testing

Run a goal-driven browser journey with a tester that has no repository context. Keep site preparation, private success checks, and product diagnosis in the coordinator context.

## Prepare the run

1. Read the selected journey in `acceptance/journeys/`.
2. Check the journey's `status` and `requires` frontmatter. If its status is `needs-profile`, report the missing bootstrap requirements and stop. Do not substitute a simpler profile or relax the journey.
3. Read its site profile in `acceptance/sites/` and the portable tester instructions in `acceptance/tester/SKILL.md`.
4. Choose the journey's target. Use Node unless the journey or change under test requires the Cloudflare runtime.
5. Start one disposable site:

   ```console
   pnpm ux:site:start -- --target node --profile editorial-small
   ```

6. Keep the run ID, start URL, and run-data path from the command output. Never send the run-data file or API token to the tester.

## Isolate the tester

Create the tester outside the repository checkout. Give it only:

- the contents of `acceptance/tester/SKILL.md`;
- the journey's `Tester brief` section;
- the generated start URL;
- a writable location for its report and screenshots.

Do not give the tester `AGENTS.md`, repository skills, source files, route names, the coordinator checks, or implementation context. Do not describe a clean context as isolated when the selected agent mechanism still exposes the checkout. If the environment cannot create a separate context within the user's authorization, prepare the handoff and ask the user to launch it.

Use any agent implementation that provides browser control. Do not translate the brief into tool-specific click instructions.

## Verify and report

Wait for the tester to finish or explicitly give up. Preserve its action log, screenshots, and report without rewriting its observations.

The rest: https://github.com/emdash-cms/emdash/blob/HEAD/skills/ux-acceptance-coordinator/SKILL.md