Agent skill

cmux Screenshot and Recording

by manaflow-ai in manaflow-ai/cmux

Captures PNG or JPEG screenshots and MP4 or GIF clips of cmux windows from the command line, as visual evidence for pull requests and bug reports.

Custom licenceAuto-check passedTesting & QA

Install cmux Screenshot and Recording

skills CLI
$ npx skills add manaflow-ai/cmux --skill cmux-capture -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install manaflow-ai/cmux cmux-capture --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/manaflow-ai/cmux.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/cmux-capture .claude/skills/cmux-capture && rm -rf skills-src

Use ~/.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/

Facts

Skill name
cmux-capture
GitHub stars
28k
Token cost
~992 tokens
SKILL.md length
530 words
Files
2 (incl. references)
Skills in repo
22
Repo updated
First seen
Licence
Custom licence

At a glance

Captures PNG or JPEG screenshots and MP4 or GIF clips of cmux windows from the command line, as visual evidence for pull requests and bug reports.

  • Attaching a screenshot of a UI change to a pull request
  • SKILL.md covers Which one, Working from a clip to a still, Notes for an agent recording… and In a CI dogfood tour, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Recording a drag or animation that text cannot describe

What it does

The cmux CLI can write a still image of a cmux window with cmux shot and a video clip with cmux record. Both capture only cmux's own windows through a path that needs no Screen Recording permission, and both work in release builds and in CI. The skill tells the agent which to use: a screenshot for static things such as a sheet, a menu or a color, and a recording for changes over time such as a drag, an animation or a spinner that should stop.

A region option takes the same rectangle in both commands, so a detail spotted in a clip can be captured as a still with identical coordinates. Recordings stop on their own at the max-seconds limit, which defaults to 15 and is capped at 120, only one can run at a time, and list and status commands show what is running. A note command draws captions into the clip, and the clip contains only cmux even if another app covers its window.

When your agent uses it

  • Attaching a screenshot of a UI change to a pull request
  • Recording a drag or animation that text cannot describe
  • Showing a reviewer the current state of the app as evidence

Example prompts

  • “Take a screenshot of the cmux settings sheet for this PR.”
  • “Record a short GIF of the sidebar drag so the reviewer can see the bug.”
  • “Capture the sidebar region before and after my change and label both.”

Requirements

  • The cmux terminal app with its cmux command-line tool

What it can do on your machine

Read from SKILL.md and the folder at commit 1e82fa4. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    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

cmux Screenshot and Recording loads about 992 tokens when it runs, and up to ~2.7k if it reads all its reference files. Until then it costs about 73 tokens; SKILL.md has 530 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~73
When it runs · the whole SKILL.md, loaded when a task matches
~992
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.7k

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 530 words (~992 tokens).

“cmux shot writes a png or a jpeg of a cmux window. cmux record writes an mp4 or a gif of one. Both capture only cmux's own windows, both go through the same permission-free path, and both work in a…”

— opening of SKILL.md by manaflow-ai, Custom licence
name
cmux-capture

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (references) in skills/cmux-capture of manaflow-ai/cmux.

  • SKILL.md
  • references/commands.md

Open the folder on GitHubat commit 1e82fa4

Compare with similar skills

cmux Screenshot and Recording 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.

cmux Screenshot and Recording compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
cmux Screenshot and Recording this skillmanaflow-ai/cmux28k—~992Automated safety check: PassCustom licence
Neru File Issuey3owk1n/neru805—~890Automated safety check: PassMIT
Playwright Screen Recordingliaohch3/claude-tap3.3k—~714Automated safety check: PassMIT
Ax RepoNecmttn/ax115—~1.8kAutomated safety check: PassAGPL-3.0
Smokenightly-labs/openbot507—~1.6kAutomated safety check: NotesCustom licence
Dev CompleteFHIR/fhir-codegen155—~9.6kAutomated safety check: PassMIT

Similar skills

  • Neru File Issue

    y3owk1n/neru

    File a Neru bug report or feature request that matches the repo's issue forms: duplicate check first, every required field filled with real diagnostics, correct labels.

    805 GitHub stars~890 tokensUpdated today
    Testing & QAAuto-check passed
  • Playwright Screen Recording

    liaohch3/claude-tap

    Records headless Playwright sessions as .webm videos to show a bug fix working or to give pull request reviewers visual evidence.

    3.3k GitHub stars~714 tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Ax Repo

    Necmttn/ax

    Star the ax repo, file an issue / bug report, or fork-and-open-a-PR against github.com/Necmttn/ax on the user's behalf, by shelling out to the gh CLI.

    115 GitHub stars~1.8k tokensUpdated 4 days ago
    Testing & QAAuto-check passed
  • Smoke

    nightly-labs/openbot

    Start one or more local OpenBot dev instances and smoke test the features that the current changes or a pull request add.

    507 GitHub stars~1.6k tokensUpdated today
    Testing & QAAuto-check: notes
  • Dev Complete

    FHIR/fhir-codegen

    Drives the entire local inner loop in one invocation, as a conductor over the skills that own each role.

    155 GitHub stars~9.6k tokensUpdated 3 days ago
    Testing & QAAuto-check passed
  • Coderabbit Hello World

    jeremylongshore/tons-of-skills-marketplace

    Run a bounded first pull-request review with minimal supported configuration and explicit cleanup.

    2.8k GitHub stars~1.1k tokensUpdated yesterday
    Testing & QAAuto-check passed

More from manaflow-ai/cmux

All 22 skills in this repo
  • cmux Diagnostics

    manaflow-ai/cmux

    Runs a read-only health check for cmux and explains what it finds, covering the CLI and socket, settings, agent hooks, session restore and notifications.

    28k GitHub starsUsed in 1 repo~819 tokens
    Auto-check passed
  • cmux Settings Editor

    manaflow-ai/cmux

    Reads and changes cmux preferences in `~/.config/cmux/cmux.json` through a helper that validates each change before writing, covering terminal, browser, viewers and shortcuts.

    28k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • cmux Backend Rules

    manaflow-ai/cmux

    Sets the backend TypeScript and Cloud VM rules for cmux: Effect-based services, thin route handlers, Postgres as source of truth, migrations and provider secrets.

    28k GitHub starsUsed in 1 repo~682 tokens
    Auto-check passed
  • Cmux Debugging Guide

    manaflow-ai/cmux

    Covers debug logging, the Debug menu, profiling rules and runtime pitfalls for working on the cmux macOS terminal app.

    28k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • Workflow rules for the Ghostty submodule in cmux: rebuilding GhosttyKit.xcframework, pushing fork changes and updating the parent submodule pointer safely.

    28k GitHub starsUsed in 1 repo~580 tokens
    Auto-check passed
  • Cmux Release Workflow

    manaflow-ai/cmux

    Runs the cmux release process: gathers per-PR changelog lines since the last tag, bumps the version, guards against a bad tag, then tags and pushes the macOS DMG release.

    28k GitHub starsUsed in 1 repo~856 tokens
    Auto-check passed

Works with

Questions about cmux Screenshot and Recording

What does cmux Screenshot and Recording do?

Captures PNG or JPEG screenshots and MP4 or GIF clips of cmux windows from the command line, as visual evidence for pull requests and bug reports. The cmux CLI can write a still image of a cmux window with cmux shot and a video clip with cmux record. Both capture only cmux's own windows through a path that needs no Screen Recording permission, and both work in release builds and in CI.

When should I use cmux Screenshot and Recording?

cmux Screenshot and Recording fits situations like: attaching a screenshot of a UI change to a pull request; recording a drag or animation that text cannot describe; showing a reviewer the current state of the app as evidence.

How do I install cmux Screenshot and Recording in Claude Code?

Run `npx skills add manaflow-ai/cmux --skill cmux-capture -a claude-code`. Or copy the skill folder (skills/cmux-capture in manaflow-ai/cmux) into .claude/skills/cmux-capture in your project. Claude Code loads it when a task matches its description.

How do I install cmux Screenshot and Recording in Codex?

Run `npx skills add manaflow-ai/cmux --skill cmux-capture -a codex`. Or copy the skill folder (skills/cmux-capture in manaflow-ai/cmux) into .agents/skills/cmux-capture in your project. Codex loads it when a task matches its description.

Can I use cmux Screenshot and Recording 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 manaflow-ai/cmux --skill cmux-capture -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cmux-capture, .gemini/skills/cmux-capture, .github/skills/cmux-capture and .opencode/skills/cmux-capture in your project.

What does cmux Screenshot and Recording need to run?

SKILL.md names no scripts, command-line tools or credentials: cmux Screenshot and Recording is instructions for the agent only. Our summary lists: The cmux terminal app with its cmux command-line tool.

Does cmux Screenshot and Recording access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is cmux Screenshot and Recording 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 cmux Screenshot and Recording use?

cmux Screenshot and Recording has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does cmux Screenshot and Recording use?

About 992 tokens (SKILL.md is roughly 4k 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 1.7k tokens, read only when the agent opens those files.

What are the alternatives to cmux Screenshot and Recording?

Skills that share tags, products or a category with cmux Screenshot and Recording: Neru File Issue (y3owk1n/neru, 805 stars), Playwright Screen Recording (liaohch3/claude-tap, 3.3k stars), Ax Repo (Necmttn/ax, 115 stars) and Smoke (nightly-labs/openbot, 507 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains cmux Screenshot and Recording?

manaflow-ai (a GitHub organization) maintains it in manaflow-ai/cmux, which has 28,092 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on October 11, 2026.

Source: manaflow-ai/cmux on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.