UI Review Tahoe
KartikLabhshetwar/better-shot
Comprehensive UI/UX review for macOS Tahoe apps. An agent skill from KartikLabhshetwar/better-shot.
Review and improve WAYFINDER's native macOS UX against OpenAI Codex app patterns and the repo's accepted menu-bar design contracts.
Install Wayfinder Codex UX Review
$ npx skills add asdecided/WayfinderRouter --skill wayfinder-codex-ux-review -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install asdecided/WayfinderRouter wayfinder-codex-ux-review --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/asdecided/WayfinderRouter.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/wayfinder-codex-ux-review .claude/skills/wayfinder-codex-ux-review && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "wayfinder-codex-ux-review" agent skill from https://github.com/asdecided/WayfinderRouter/tree/main/.agents/skills/wayfinder-codex-ux-review into .claude/skills/wayfinder-codex-ux-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "wayfinder-codex-ux-review", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/asdecided/WayfinderRouter/tree/main/.agents/skills/wayfinder-codex-ux-reviewType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add asdecided/WayfinderRouter --skill wayfinder-codex-ux-review -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install asdecided/WayfinderRouter wayfinder-codex-ux-review --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/asdecided/WayfinderRouter.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/wayfinder-codex-ux-review .agents/skills/wayfinder-codex-ux-review && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "wayfinder-codex-ux-review" agent skill from https://github.com/asdecided/WayfinderRouter/tree/main/.agents/skills/wayfinder-codex-ux-review into .agents/skills/wayfinder-codex-ux-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "wayfinder-codex-ux-review", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add asdecided/WayfinderRouter --skill wayfinder-codex-ux-review -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install asdecided/WayfinderRouter wayfinder-codex-ux-review --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/asdecided/WayfinderRouter.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/wayfinder-codex-ux-review .cursor/skills/wayfinder-codex-ux-review && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "wayfinder-codex-ux-review" agent skill from https://github.com/asdecided/WayfinderRouter/tree/main/.agents/skills/wayfinder-codex-ux-review into .cursor/skills/wayfinder-codex-ux-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "wayfinder-codex-ux-review", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/asdecided/WayfinderRouter.git --path .agents/skills/wayfinder-codex-ux-review--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add asdecided/WayfinderRouter --skill wayfinder-codex-ux-review -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install asdecided/WayfinderRouter wayfinder-codex-ux-review --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/asdecided/WayfinderRouter.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/wayfinder-codex-ux-review .gemini/skills/wayfinder-codex-ux-review && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "wayfinder-codex-ux-review" agent skill from https://github.com/asdecided/WayfinderRouter/tree/main/.agents/skills/wayfinder-codex-ux-review into .gemini/skills/wayfinder-codex-ux-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "wayfinder-codex-ux-review", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install asdecided/WayfinderRouter wayfinder-codex-ux-reviewInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add asdecided/WayfinderRouter --skill wayfinder-codex-ux-review -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/asdecided/WayfinderRouter.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/wayfinder-codex-ux-review .github/skills/wayfinder-codex-ux-review && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "wayfinder-codex-ux-review" agent skill from https://github.com/asdecided/WayfinderRouter/tree/main/.agents/skills/wayfinder-codex-ux-review into .github/skills/wayfinder-codex-ux-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "wayfinder-codex-ux-review", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add asdecided/WayfinderRouter --skill wayfinder-codex-ux-review -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install asdecided/WayfinderRouter wayfinder-codex-ux-review --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/asdecided/WayfinderRouter.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/wayfinder-codex-ux-review .opencode/skills/wayfinder-codex-ux-review && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "wayfinder-codex-ux-review" agent skill from https://github.com/asdecided/WayfinderRouter/tree/main/.agents/skills/wayfinder-codex-ux-review into .opencode/skills/wayfinder-codex-ux-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "wayfinder-codex-ux-review", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
wayfinder-codex-ux-review- GitHub stars
- 417
- Token cost
- ~1.1k tokens
- SKILL.md length
- 468 words
- Files
- 3 (incl. references)
- Skills in repo
- 2
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Review and improve WAYFINDER's native macOS UX against OpenAI Codex app patterns and the repo's accepted menu-bar design contracts.
- Works in 5 steps: Confirm the target surface → Read references/codex-ux-reference.md… → Inspect the current Swift implementation… → …
- Working on the Swift macOS app
- SKILL.md covers Overview, Core Workflow, UX Priorities and Codex Product Source, plus 2 more sections
- Calls swift
What it does
Wayfinder Codex UX Review is an agent skill from asdecided/WayfinderRouter. Review and improve WAYFINDER's native macOS UX against OpenAI Codex app patterns and the repo's accepted menu-bar design contracts. Use when working on the Swift macOS app, menu-bar popover, chat window, settings window, native app screenshots, Codex-like interaction design, or UX review tasks that mention WAYFINDER, Codex, Codex app, Browser plugin, in-app browser, or OpenAI product reference.
Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `agents/openai.yaml` and `references/codex-ux-reference.md`).
It sits in Frontend & Design, covering UX design and iOS development. It works with macOS and OpenAI. The repository describes itself as: Simple CLI tool for deterministic routing of queries between local and hosted LLM models. The licence is Apache-2.0.
When your agent uses it
- Working on the Swift macOS app
- Menu-bar popover
- Settings window
- Native app screenshots
Example prompts
- “s native macOS UX against OpenAI Codex app patterns and the repo”
- “/wayfinder-codex-ux-review”
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
- Confirm the target surface
- Read references/codex-ux-reference.md before making UX judgments.
- Inspect the current Swift implementation before prescribing changes. Start with
- Make UX changes in the smallest native surface that owns the behavior. Prefer SwiftUI/AppKit-native structure over web-era assumptions.
- Verify with the strongest available check
What it can do on your machine
Read from SKILL.md and the folder at commit 075f17c. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
swift
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
developers.openai.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Wayfinder Codex UX Review loads about 1.1k tokens when it runs, and up to ~1.8k if it reads all its reference files. Until then it costs about 106 tokens; SKILL.md has 468 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from asdecided/WayfinderRouter at commit 075f17c, republished under its Apache-2.0 licence (© asdecided). 468 words, ~1,076 tokens.
Download SKILL.mdSave it as
.claude/skills/wayfinder-codex-ux-review/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.- name
- wayfinder-codex-ux-review
- description
- Review and improve WAYFINDER's native macOS UX against OpenAI Codex app patterns and the repo's accepted menu-bar design contracts. Use when working on the Swift macOS app, menu-bar popover, chat window, settings window, native app screenshots, Codex-like interaction design, or UX review tasks that mention WAYFINDER, Codex, Codex app, Browser plugin, in-app browser, or OpenAI product reference.
WAYFINDER Codex UX Review
Overview
Use this skill to audit or revise the WAYFINDER native macOS experience so it feels closer to the OpenAI Codex product where that analogy is useful: quiet, thread-centered, dense but readable, tool-aware, and reviewable. Keep WAYFINDER's own architecture and accepted design contracts authoritative.
Core Workflow
- Confirm the target surface:
- Native Swift app:
macos/WayfinderMac. - Legacy web/Tauri client:
clients/desktop, only when the task explicitly references it. - Product docs/design contracts:
macos/README.md,decisions/WF-ADR-0042-desktop-menu-bar-client.md,designs/WF-DESIGN-0012-desktop-popover-design.md, anddesigns/WF-DESIGN-0014-flat-list-popover.md.
- Native Swift app:
- Read
references/codex-ux-reference.mdbefore making UX judgments. - Inspect the current Swift implementation before prescribing changes. Start with:
macos/WayfinderMac/Package.swiftmacos/WayfinderMac/Sources/WayfinderMacApp/WayfinderMacMain.swiftmacos/WayfinderMac/Sources/WayfinderMac/WayfinderMacApp.swift
- Make UX changes in the smallest native surface that owns the behavior. Prefer SwiftUI/AppKit-native structure over web-era assumptions.
- Verify with the strongest available check:
- Run
swift testfor behavior that can be tested. - Run
swift run WayfinderMacfor visual/manual review when feasible. - Use screenshots or Computer Use for native macOS visual inspection when available.
- Use the Browser plugin only for local web previews, docs, or browser-rendered prototypes; do not treat it as the primary inspection tool for native Swift UI.
- Run
UX Priorities
- Preserve the menu-bar utility shape: fast glance, transient popover, native calm, no decorative landing-page energy.
- Make the routing decision legible first. The product is the decision, not a generic chat wrapper.
- Favor flat native menu grammar: rows, hairlines, compact labels, restrained icons, clear status, and no card grids unless an accepted design doc calls for one.
- Mirror Codex at the interaction level: persistent thread context, clear task state, tool/action affordances, reviewability, precise feedback loops, and compact controls.
- Avoid copying Codex visual details that conflict with WAYFINDER's accepted tokens, route colors, privacy claims, or menu-bar constraints.
- Keep privacy language exact: offline mode is the only mode that guarantees nothing leaves the machine.
- Prefer native accessibility: keyboard reachability, VoiceOver labels, reduced motion, visible focus, and no hidden action behind hover-only UI.
Show full SKILL.md (156 more words)Show less
Codex Product Source
Use references/codex-ux-reference.md for the stable review lens. When the task needs current Codex product facts, first use the OpenAI docs/Codex manual workflow rather than relying on memory.
Relevant public source anchors:
- https://developers.openai.com/codex/app/features
- https://developers.openai.com/codex/app/browser
- https://developers.openai.com/codex/skills
- https://developers.openai.com/codex/plugins
Browser Plugin Guidance
For native Swift work, do not lead with the Browser plugin. Use it when:
- The task includes a local web preview, rendered documentation, or prototype route.
- A legacy
clients/desktopVite/Tauri page needs inspection. - The user explicitly asks to use
@Browseror the in-app browser.
When using Browser, keep the task scoped to a concrete URL, viewport, state, and visible issue. For native macOS UI, ask for or capture screenshots instead.
Output Shape
For UX review, lead with prioritized findings grounded in the visible UI or source files. For implementation, summarize the changed surfaces and the verification performed.
For design direction, separate "Codex-like" from "WAYFINDER-specific" so future changes do not flatten the product into a copy.
© asdecided, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 2 other files (references) in .agents/skills/wayfinder-codex-ux-review of asdecided/WayfinderRouter.
- SKILL.md
- agents/openai.yaml
- references/codex-ux-reference.md
Open the folder on GitHubat commit 075f17c
Compare with similar skills
Wayfinder Codex UX Review next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Wayfinder Codex UX Review this skillasdecided/WayfinderRouter | 417 | — | ~1.1k | Automated safety check: Pass | Apache-2.0 | |
| UI Review TahoeKartikLabhshetwar/better-shot | 2.4k | 2 repos | ~1.7k | Automated safety check: Pass | Custom licence | |
| UI Automation Workflowsconorluddy/xclaude-plugin | 183 | — | ~2.2k | Automated safety check: Pass | MIT | |
| App Icon Generatorrshankras/claude-code-apple-skills | 787 | — | ~5.1k | Automated safety check: Notes | MIT | |
| macOS Golden Gate Designgithub/awesome-copilot | 40k | — | ~2.1k | Automated safety check: Pass | MIT | |
| Apple Hig Helpershepherdjerred/monorepo | 112 | — | ~4.6k | Automated safety check: Pass | GPL-3.0 |
Similar skills
UI Automation Workflows
conorluddy/xclaude-plugin
Accessibility-first UI automation using IDB. An agent skill from conorluddy/xclaude-plugin.
App Icon Generator
rshankras/claude-code-apple-skills
Generates an app icon for macOS or iOS — a fast CoreGraphics placeholder and/or flat layered source art to finish in Icon Composer (the Liquid Glass / iOS 26+ standard).
- Official
macOS Golden Gate Design
github/awesome-copilot
Design, implement, review, or refactor native macOS 27 Golden Gate interfaces in SwiftUI or AppKit.
Apple Hig Helper
shepherdjerred/monorepo
Apple Human Interface Guidelines - comprehensive design guidance for iOS, macOS, visionOS, watchOS, tvOS, and Apple technologies with summaries of 174 topics.
AgentSquad for Swift
2FastLabs/agent-squad
Guides building on-device multi-agent apps in Swift with the AgentSquad framework: which agent, orchestrator, classifier, storage or voice type fits each situation.
More from asdecided/WayfinderRouter
Wayfinder Triage
asdecided/WayfinderRouter
Triage the Wayfinder repo in one pass — survey open PRs (CI status, review comments, mergeability) and open issues / feature requests, report what needs action, then drive small, clear fixes…
Related
Categories
Questions about Wayfinder Codex UX Review
What does Wayfinder Codex UX Review do?
Review and improve WAYFINDER's native macOS UX against OpenAI Codex app patterns and the repo's accepted menu-bar design contracts. Wayfinder Codex UX Review is an agent skill from asdecided/WayfinderRouter. Review and improve WAYFINDER's native macOS UX against OpenAI Codex app patterns and the repo's accepted menu-bar design contracts.
When should I use Wayfinder Codex UX Review?
Wayfinder Codex UX Review fits situations like: working on the Swift macOS app; menu-bar popover; settings window; native app screenshots.
How do I install Wayfinder Codex UX Review in Claude Code?
Run `npx skills add asdecided/WayfinderRouter --skill wayfinder-codex-ux-review -a claude-code`. Or copy the skill folder (.agents/skills/wayfinder-codex-ux-review in asdecided/WayfinderRouter) into .claude/skills/wayfinder-codex-ux-review in your project. Claude Code loads it when a task matches its description.
How do I install Wayfinder Codex UX Review in Codex?
Run `npx skills add asdecided/WayfinderRouter --skill wayfinder-codex-ux-review -a codex`. Or copy the skill folder (.agents/skills/wayfinder-codex-ux-review in asdecided/WayfinderRouter) into .agents/skills/wayfinder-codex-ux-review in your project. Codex loads it when a task matches its description.
Can I use Wayfinder Codex UX Review in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add asdecided/WayfinderRouter --skill wayfinder-codex-ux-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/wayfinder-codex-ux-review, .gemini/skills/wayfinder-codex-ux-review, .github/skills/wayfinder-codex-ux-review and .opencode/skills/wayfinder-codex-ux-review in your project.
What does Wayfinder Codex UX Review need to run?
Going by SKILL.md and its folder, Wayfinder Codex UX Review needs the command-line tools its instructions call (swift).
Does Wayfinder Codex UX Review access the network?
SKILL.md names 1 domain. As links in the text: developers.openai.com. This is read from the text; nothing was executed.
Is Wayfinder Codex UX Review safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Wayfinder Codex UX Review use?
Wayfinder Codex UX Review is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Wayfinder Codex UX Review use?
About 1.1k tokens (SKILL.md is roughly 4.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 725 tokens, read only when the agent opens those files.
What are the alternatives to Wayfinder Codex UX Review?
Skills that share tags, products or a category with Wayfinder Codex UX Review: UI Review Tahoe (KartikLabhshetwar/better-shot, 2.4k stars), UI Automation Workflows (conorluddy/xclaude-plugin, 183 stars), App Icon Generator (rshankras/claude-code-apple-skills, 787 stars) and macOS Golden Gate Design (github/awesome-copilot, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Wayfinder Codex UX Review?
asdecided (a GitHub organization) maintains it in asdecided/WayfinderRouter, which has 417 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 5, 2026.
Source: asdecided/WayfinderRouter on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.