feat: add audit-ux-journeys skill (v1.13.0)#14
Merged
Conversation
Cross-page UX audit for user stories, task completion, and information architecture - the layer audit-ux (per-page heuristics) doesn't cover. Derives real stories from routes/nav/CTAs, audits IA structurally (IA1-IA9), walks every story end-to-end in a headed browser, enforces [data]/[observed]/[judgment] evidence discipline, reports impact x effort. audit-ux rescoped to the per-page lens with cross-links. Skill count 109 -> 110.
There was a problem hiding this comment.
Pull request overview
This PR introduces a new cross-page UX auditing skill focused on user stories, task completion, and information architecture, and updates the existing audit-ux skill to clearly scope it to a per-page heuristic lens. It also bumps the package version to v1.13.0 and updates repository docs/indexes to reflect the new skill and updated counts.
Changes:
- Added new
audit-ux-journeysskill with a structured multi-phase method and a detailed IA/journey checklist reference. - Rescoped
audit-uxmessaging to the per-page lens and cross-linked toaudit-ux-journeysfor cross-page audits. - Updated skill catalogs, trigger cheatsheets, counts, and versioning to reflect 109 → 110 agent skills (and 121 → 122 installable skills).
Reviewed changes
Copilot reviewed 13 out of 13 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| skills/audit-ux/SKILL.md | Updates description + Step 0c note to scope audit-ux as per-page and delegate cross-page journeys/IA to audit-ux-journeys. |
| skills/audit-ux-journeys/SKILL.md | Adds the new cross-page UX journey/IA audit skill and its phased workflow + reporting format. |
| skills/audit-ux-journeys/references/checklist.md | Adds a detailed checklist and detection methods supporting the new skill’s phases. |
| rules/skill-workflows.mdc | Adds audit-ux-journeys to the workflow routing table. |
| .cursor/rules/skill-workflows.mdc | Mirrors the workflow routing update for Cursor rules. |
| README.md | Updates counts, skill family totals, and adds audit-ux-journeys to the generated index + “start here” guidance. |
| docs/CATALOG.md | Adds/links the new skill and clarifies audit-ux scope vs journeys. |
| docs/TRIGGER-CHEATSHEET.md | Adds trigger phrases for audit-ux-journeys. |
| docs/PROMOTION.md | Updates promotional copy to reflect 110 agent skills. |
| CHANGELOG.md | Adds v1.13.0 release notes describing the new skill and the audit-ux scope change. |
| package.json | Bumps version to 1.13.0 and updates package description counts. |
| llms.txt | Updates the headline counts to 110 agent skills. |
| .cursor-plugin/plugin.json | Bumps plugin version/description to 1.13.0 and updates counts. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Comment on lines
+123
to
+125
| Rules: screenshots to `.playwright-mcp/` per the artifact-hygiene rule; forms judged only for | ||
| flow-level friction (field-level → `enhance-web-forms`); per-page heuristic violations noticed | ||
| along the way are *handed to* `audit-ux`, not re-audited here. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
audit-ux-journeysskill (Skill 110): cross-page UX audit for user stories, task completion, and information architecture — the layeraudit-ux(per-page heuristics) doesn't cover.design-prd/plan-test-coverageinventories); scope depth by audit trigger (KPIs / complaints / redesign / pre-launch).[data]/[observed]/[judgment]tags; validates against GA4/PostHog/Clarity funnels when present.audit-uxrescoped to the per-page lens (description + Step 0c cross-link).Test plan
npm testgreen (validate, counts, skill index, secrets, MCP pins, completion gate, install smoke)