Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot

cmux-testing — Claude Code skill: Swift testing and test wiring

Skill for choosing verification scopes, adding tests, and validating Swift test targets in the cmux project. Decides what local and CI evidence a change needs.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add manaflow-ai/cmux --skill cmux-testing -a claude-code
Open on GitHub

What cmux-testing does

cmux-testing provides commands to run checks at different scales: from parsing changed Swift code to the full CI static recipe. Inside the repository, scripts like verify-local.py handle syntax and test-file wiring, ui-test captures UI test frames, ui-lab.py renders views to PNG without building the app, and run-e2e.sh runs E2E scenarios with screenshots.

The skill teaches you to distinguish between local and CI checks: package, native, web, or runtime. It helps you isolate a failing behavior to one focused test, then verify the fix runs the same command. For new test files in cmuxTests/, wiring in project.pbxproj is required—the skill shows how via sync-test-wiring or lint-pbxproj-test-wiring.sh.

One hard requirement: repository commands run only from a trusted checkout; even --help loads project code. Swift tests must use Swift Testing (import Testing, @Test), UI tests stay in XCTest/XCUITest. Never assert AST shape or metadata keys as a mirror of implementation—you need a real behavioral oracle or artifact.

What it helps with

  • choose the right verification scope for local testing
  • validate Swift test file wiring in the project
  • isolate and fix a bug with proof of the regression
  • render views to images without building the app
  • tell if a web test failure is real or a flake

Example prompts for the agent

  • Help me decide if this change needs local tests
  • Set up cmux-testing and show me how to run a focused test for this feature
  • I added a new file to cmuxTests—how do I verify it's wired correctly?

How to install cmux-testing

1Skills CLI (Vercel)

npx skills add manaflow-ai/cmux --skill cmux-testing -a claude-code

2Manually: put the files in place

~/.claude/skills/cmux-testing/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/cmux-testing/

From the same set12

The whole set →
cmux manaflow-ai Skill for navigating multi-pane cmux layouts: create windows, workspaces, splits, focus surfaces, and move terminals and browser panels without breaking automation. Use it when an agent needs deterministic placement and routing. Claude Code CX Codex Cursor +1 9,600installs cmux-browser manaflow-ai Automates browser surfaces via the cmux CLI without stealing user focus. Useful for background page inspections, waiting on selectors, and form fills. Claude Code CX Codex Cursor +1 8,800installs cmux-customization manaflow-ai Configures the cmux workspace manager: edits cmux.json, wires Command Palette actions, sets dock terminals, and routes terminal-level styling directly to Ghostty. Claude Code CX Codex Cursor +1 6,600installs cmux-diagnostics manaflow-ai Skill runs read-only cmux diagnostics: sockets, hooks, session restore, settings. Use when notifications fail, agents don't resume, or you need a support-safe debug report. Claude Code CX Codex Cursor +1 6,400installs cmux-keyboard-shortcuts manaflow-ai Configures cmux shortcuts in ~/.config/cmux/cmux.json. Useful for adopting tmux-style chords, auditing overrides, and validating syntax. Claude Code CX Codex Cursor +1 6,200installs cmux-custom-sidebar manaflow-ai Skill for writing a custom cmux sidebar in a SwiftUI-like language. The sidebar binds to workspaces, tabs, PRs, and clock; hot-reloads on save; runs cmux commands on tap. Claude Code CX Codex Cursor +1 4,800installs cmux-architecture manaflow-ai Guides modular Swift package architecture, strict 5-layer dependency inversion, and Swift 6 concurrency rules in the cmux codebase. Claude Code CX Codex Cursor +1 4,800installs cmux-ghostty manaflow-ai Enforces workflow guidelines for the Ghostty submodule and GhosttyKit compilation in cmux. Useful when syncing the fork or committing submodule pointers. Claude Code CX Codex Cursor +1 4,700installs

Similar

php-pro https://github.com/Jeffallan Enforces PHP 8.3+ standards across Laravel and Symfony projects with strict typing, PHPStan level 9 checks, and automated Pest tests. Claude Code CX Codex Cursor +1 15,500installs llm-evaluation Seth Hobson A skill for evaluating LLM applications: automated metrics, human feedback, LLM-as-judge and benchmarking. Useful when comparing models or catching regressions before deploy. Claude Code CX Codex Cursor 12,755installs protocol-reverse-engineering Dávid Balatoni This skill helps inspect network traffic, map protocol structures, and write protocol documentation. Use it for proprietary protocol analysis or network debugging. Claude Code CX Codex Cursor 12,701installs dogfood callstack Coordinates exploratory mobile app testing on iOS and Android via agent-device. Discovers UI bugs and workflow issues in runtime. Claude Code CX Codex Cursor +1 11,200installs wcag-audit-patterns Seth Hobson Audits web interfaces against WCAG 2.2 with automated checks and manual verification. Use it to find violations and build accessible patterns. Claude Code CX Codex Cursor 12,486installs improve-codebase-architecture Matt Pocock This skill scans a codebase for architectural friction, then builds a visual HTML report with refactoring candidates. Use it before a deeper architecture review. Claude Code 1,163,035installs design-taste-frontend Leonxlnx This skill directs the design of public pages and work screens, then checks the result in a browser through screenshots. Use it when an interface feels generic or unfinished. Claude Code CX Codex Cursor +1 673,100installs tdd Matt Pocock Guides the red-green TDD loop: ensures tests are written first, keep them at public interfaces, and avoid coupling to implementation details. Claude Code 1,141,062installs

Questions about cmux-testing

How do I install cmux-testing in Claude Code?

Run npx skills add manaflow-ai/cmux --skill cmux-testing -a claude-code, then find ~/.claude/skills/cmux-testing/SKILL.md.

What does cmux-testing do?

It provides commands to pick verification scopes (syntax, tests, wiring), isolate bugs, and validate Swift targets in cmux. It helps you decide what local or CI evidence a change requires.

Should I migrate XCTest to Swift Testing?

Swift Testing is used for new unit and integration targets. Migrate XCTest only if you're already editing that file. UI tests remain in XCTest/XCUITest.

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor