universal-mcp-sync: Skill for Claude Code

.claude/skills/ux-bug-hunt/SKILL.md

ux-bug-hunt is a skill for Claude Code from nawodyaishan/universal-mcp-sync. It costs 119 tokens per session (2,276 once invoked), scanned A, original, MIT.

A project-specific workflow for finding and fixing user-interface problems in the usync terminal interface, or TUI. It runs predefined scenarios in a Docker test environment, then reviews and categorizes the results.

In plain words
What is it for?
Use it to expand the test scenarios, run the Docker-based harness, triage findings, and repeat the process for TUI regressions and other interface bugs.
Why use it?
It turns repeated UI testing into a controlled loop and helps prevent reported interaction problems from being overlooked.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter.

This is nawodyaishan/universal-mcp-sync's own configuration. It tells Claude Code how to work on universal-mcp-sync itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything universal-mcp-sync configures →

Not installable: its command points at a path on the author’s own machine, so it runs nowhere else. The line is /Users/nawodyaishan/Documents/GitHub/mcp-config-tui.

Reuse

Borrowing it

Nothing to install: this file belongs to nawodyaishan/universal-mcp-sync. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/nawodyaishan/universal-mcp-sync/main/.claude/skills/ux-bug-hunt/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/nawodyaishan/universal-mcp-sync

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ux-bug-hunt

README.md
[![agentmods](https://agentmods.dev/badge/skills/nawodyaishan/universal-mcp-sync/ux-bug-hunt/github.svg)](https://agentmods.dev/skills/nawodyaishan/universal-mcp-sync/ux-bug-hunt)
Your own site
<a href="https://agentmods.dev/skills/nawodyaishan/universal-mcp-sync/ux-bug-hunt"><img src="https://agentmods.dev/badge/skills/nawodyaishan/universal-mcp-sync/ux-bug-hunt/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for ux-bug-hunt

Your own site · 80×15
<a href="https://agentmods.dev/skills/nawodyaishan/universal-mcp-sync/ux-bug-hunt"><img src="https://agentmods.dev/badge/skills/nawodyaishan/universal-mcp-sync/ux-bug-hunt.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 119 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,276 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00119 $0.02276
Opus 5 $0.00060 $0.01138
Sonnet 5 $0.00024 $0.00455
Haiku 4.5 $0.00012 $0.00228

Measured 12d ago against content hash bba181800d35, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

ux-bug-hunt scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/ux-bug-hunt/SKILL.md · 159 lines

How it starts

The opening of the file, as written. The whole thing — 159 lines — stays where its author put it; the contents beside it link to each section on GitHub.

UX Bug-Hunt Iteration (usync / mcp-config-tui)

Scope: This skill is personalized to the mcp-config-tui repository. Every file path below is relative to the repo root (/Users/nawodyaishan/Documents/GitHub/mcp-config-tui). It will not work in any other project — the harness, scenarios, and IDs are project-owned.

The Docker-first UX harness (make ux-fake-prod) is a bug-funnel, not a one-shot. Treat each iteration as a disciplined 4-stage loop and never skip stage 3 (triage).


0. Required reading (read these before doing anything)

Specs & protocol (authoritative intent)

  • docs/specs/doctor-mode-phase12/ux-bug-hunt-protocol.md — the protocol; Docker run is the authoritative collection mechanism
  • docs/specs/doctor-mode-phase12/ux-flow-matrix.md — scenario matrix; every row is a contract
  • docs/specs/doctor-mode-phase12/spec.md — Phase 12 product intent
  • docs/specs/doctor-mode-phase12/plan.md — implementation plan
  • docs/specs/doctor-mode-phase12/tasks.md — task breakdown
  • docs/specs/doctor-mode-phase12/user-flow-audit.md — audited journeys

Harness source (the runtime)

  • tests/ux-fake-prod/Dockerfile — fake-prod container build
  • tests/ux-fake-prod/docker-run.sh — entrypoint invoked by make ux-fake-prod
  • tests/ux-fake-prod/run-flow.sh — in-container scenario driver
  • .dockerignore — keep this small; image hygiene affects determinism

Test runners (the matrix)

  • pkg/tui/dashboard_fake_prod_matrix_test.go — Docker matrix runner
  • pkg/tui/dashboard_flow_matrix_test.go — local shortcut matrix runner
  • pkg/tui/dashboard_flow_test.go — base teatest flows (read for patterns)
  • pkg/tui/dashboard_golden_test.go — width/render goldens

TUI surface under test

  • pkg/tui/dashboard.goDashboardModel, screens, key handlers
  • pkg/tui/dashboard_view.go — all render* functions and action bars
  • pkg/tui/dashboard_test.go — unit tests (regression baseline)

Artifacts (the output of every run)

  • artifacts/ux-fake-prod/do not edit by hand; produced by Docker
    • matrix.json — canonical scenario × result table
    • issues.json — canonical open issues (DM-P<n> IDs)
    • fake-prod-matrix.txt — human-readable matrix
    • teatest-matrix.txt — local-test matrix
    • doctor JSON, plan JSON, fake home-after snapshot, TUI transcripts

Read the full file on GitHub · 159 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 159 lines · 119 tokens per session scan A bba181800d35

Subscribe to this mod's changes

ux-bug-hunt is a skill published in the GitHub repository nawodyaishan/universal-mcp-sync (6 stars, last pushed 1mo ago), licensed MIT. It adds 119 tokens to every session and 2,276 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

app-screenshot-debug

Drive the running termio app via AppleScript / System Events to reach a UI state (focus the window, click a sidebar project, a terminal pane, a control), capture a pixel-accurate screenshot of just that window, and read it back for visual analysis — for diagnosing layout / spacing / alignment / 'this looks ugly'…

termio-sh/termio · 161 tokens

tui-design

Design, build, refactor, or review terminal interfaces—full-screen TUIs, interactive prompts, and command-line tools. Use for terminal-app layout and UX, CLI behavior, ncurses-style tools, dashboards, REPLs, fzf-like pickers, and libraries such as Bubble Tea, Ratatui, Textual, or Ink, including requests that name a…

gfargo/tui-design-skill · 135 tokens

systematic-debugging

4-phase debugging protocol for diagnosing and fixing failing tests.

PedroMosquera/squadai · 15 tokens

critique-theater

5-dimension critique panel; emits the critique.score signal that drives devloop convergence.

wolfenazz/YzPzCode · 22 tokens

code_explorer

Explores the repository to locate primary source files, coupled UI components, and test files for bug reports or feature requests.

google-gemini/gemini-cli · 28 tokens

session-investigator

Investigate fast-agent session and history files to diagnose issues. Use when a session ended unexpectedly, when debugging tool loops, when correlating sub-agent traces with main sessions, or when analyzing conversation flow and timing. Covers session.json metadata, history JSON format, message structure, tool…

evalstate/fast-agent · 68 tokens