New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Ghostty Submodule and GhosttyKit Workflow

by manaflow-ai in manaflow-ai/cmux

Workflow rules for the Ghostty submodule in cmux: rebuilding GhosttyKit.xcframework, pushing fork changes and updating the parent submodule pointer safely.

Custom licenceAuto-check passedDevelopment

Install Ghostty Submodule and GhosttyKit Workflow

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

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

GitHub CLI
$ gh skill install manaflow-ai/cmux cmux-ghostty --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-ghostty .claude/skills/cmux-ghostty && 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-ghostty
GitHub stars
28k
Used in
1 other repo
Token cost
~580 tokens
SKILL.md length
200 words
Files
3 (incl. references)
Skills in repo
22
Repo updated
First seen
Licence
Custom licence

At a glance

Workflow rules for the Ghostty submodule in cmux: rebuilding GhosttyKit.xcframework, pushing fork changes and updating the parent submodule pointer safely.

  • Changing code inside the ghostty submodule
  • SKILL.md covers GhosttyKit builds, Submodule workflow, Submodule safety and Detailed reference
  • Calls git; reaches github.com
  • Rebuilding GhosttyKit.xcframework after a Ghostty change

What it does

The xcframework must always be rebuilt with release optimizations, using a `zig build` with the universal target and `ReleaseFast` from inside the `ghostty` folder. Ghostty changes are committed in the submodule and pushed to the `manaflow-ai/ghostty` fork, and `docs/ghostty-fork.md` is kept current with fork changes and conflict notes. Because remote names vary between checkouts, the agent runs `git remote -v` first and pushes to whichever remote is the fork, usually `origin`.

To pull in upstream `ghostty-org/ghostty`, the agent adds it as an explicit remote, fetches, and then records the new SHA in the parent repo with a commit. The safety rule applies to every submodule, including `vendor/bonsplit` and `homebrew-cmux`: push the submodule commit first, never commit on a detached HEAD or a temporary branch, and verify with `git merge-base --is-ancestor` that the commit is reachable from the remote branch. Otherwise a later checkout or CI job cannot fetch the pointed-to SHA. `references/submodule-safety.md` lists the ordered sequence.

When your agent uses it

  • Changing code inside the ghostty submodule
  • Rebuilding GhosttyKit.xcframework after a Ghostty change
  • Pulling upstream Ghostty changes into the fork and updating the parent pointer
  • Recording fork conflict notes in docs/ghostty-fork.md

Example prompts

  • “Rebuild GhosttyKit.xcframework with release optimizations after my Ghostty change.”
  • “Push my ghostty submodule commit to the fork, then update the parent repo's pointer safely.”
  • “Merge the latest upstream ghostty-org changes and note any conflicts in docs/ghostty-fork.md.”
  • “Check that the ghostty submodule commit is reachable from origin/main before I commit the pointer.”

Requirements

  • Zig to build GhosttyKit
  • A cmux checkout with the ghostty submodule
  • Push access to the manaflow-ai/ghostty fork

What it can do on your machine

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

    • git

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.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

Ghostty Submodule and GhosttyKit Workflow loads about 580 tokens when it runs, and up to ~834 if it reads all its reference files. Until then it costs about 56 tokens; SKILL.md has 200 words of instructions outside code blocks.

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

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 200 words (~580 tokens).

“Always rebuild the xcframework with Release optimizations:”

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

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files (references) in skills/cmux-ghostty of manaflow-ai/cmux.

  • SKILL.md
  • agents/openai.yaml
  • references/submodule-safety.md

Open the folder on GitHubat commit f6532b1

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in manaflow-ai/cmux, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Ghostty Submodule and GhosttyKit Workflow 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.

Ghostty Submodule and GhosttyKit Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ghostty Submodule and GhosttyKit Workflow this skillmanaflow-ai/cmux28k1 repos~580Automated safety check: PassCustom licence
Nemo Rl Auto ResearchNVIDIA/skills3.5k—~2.3kAutomated safety check: PassApache-2.0
Git Revert SafetyZaxbyHub/opencode-swarm493—~2.2kAutomated safety check: PassMIT
Finishing a Development Branchobra/superpowers297k5 repos~1.9kAutomated safety check: PassMIT
Code Design Rationale Investigatorcursor/plugins10k9 repos~2.6kAutomated safety check: PassNone
Contributor-First PR MergeHKUDS/OpenHarness16k1 repos~847Automated safety check: PassMIT

Similar skills

  • Nemo Rl Auto Research

    NVIDIA/skills

    Official

    Autonomous NeMo-RL research agent workflow for directed hypothesis testing and open-ended discovery.

    3.5k GitHub stars~2.3k tokensUpdated yesterday
    DevelopmentAuto-check passed

  • Git Revert Safety

    ZaxbyHub/opencode-swarm

    Apply when reverting commits, undoing merges, or recovering from branch contamination.

    493 GitHub stars~2.2k tokensUpdated today
    DevelopmentAuto-check passed

  • Finishing a Development Branch

    obra/superpowers

    Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    297k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed

  • Code Design Rationale Investigator

    cursor/plugins

    Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    10k GitHub starsUsed in 9 repos~2.6k tokens
    DevelopmentAuto-check passed

  • Contributor-First PR Merge

    HKUDS/OpenHarness

    Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    DevelopmentAuto-check passed

  • Migrate Internal Package into Ghost

    TryGhost/Ghost

    Moves a package from another TryGhost repository into Ghost as an internal workspace package while keeping its Git history, with checkpoints for the steps that need an administrator.

    56k GitHub stars~3.8k tokensUpdated today
    DevelopmentAuto-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

  • 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

  • cmux Browser Surface Control

    manaflow-ai/cmux

    Opens, inspects, and drives a browser surface through the cmux CLI without stealing the user's focus, always targeting an explicit surface handle.

    28k GitHub stars~2.7k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Ghostty Submodule and GhosttyKit Workflow

What does Ghostty Submodule and GhosttyKit Workflow do?

Workflow rules for the Ghostty submodule in cmux: rebuilding GhosttyKit.xcframework, pushing fork changes and updating the parent submodule pointer safely. The xcframework must always be rebuilt with release optimizations, using a `zig build` with the universal target and `ReleaseFast` from inside the `ghostty` folder.md` is kept current with fork changes and conflict notes.

When should I use Ghostty Submodule and GhosttyKit Workflow?

Ghostty Submodule and GhosttyKit Workflow fits situations like: changing code inside the ghostty submodule; rebuilding GhosttyKit.xcframework after a Ghostty change; pulling upstream Ghostty changes into the fork and updating the parent pointer; recording fork conflict notes in docs/ghostty-fork.md.

How do I install Ghostty Submodule and GhosttyKit Workflow in Claude Code?

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

How do I install Ghostty Submodule and GhosttyKit Workflow in Codex?

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

Can I use Ghostty Submodule and GhosttyKit Workflow 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-ghostty -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-ghostty, .gemini/skills/cmux-ghostty, .github/skills/cmux-ghostty and .opencode/skills/cmux-ghostty in your project.

What does Ghostty Submodule and GhosttyKit Workflow need to run?

Going by SKILL.md and its folder, Ghostty Submodule and GhosttyKit Workflow needs the command-line tools its instructions call (git). Our summary lists: Zig to build GhosttyKit; A cmux checkout with the ghostty submodule; Push access to the manaflow-ai/ghostty fork.

Does Ghostty Submodule and GhosttyKit Workflow access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Ghostty Submodule and GhosttyKit Workflow 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 Ghostty Submodule and GhosttyKit Workflow use?

Ghostty Submodule and GhosttyKit Workflow 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 Ghostty Submodule and GhosttyKit Workflow use?

About 580 tokens (SKILL.md is roughly 2.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 254 tokens, read only when the agent opens those files.

What are the alternatives to Ghostty Submodule and GhosttyKit Workflow?

Skills that share tags, products or a category with Ghostty Submodule and GhosttyKit Workflow: Nemo Rl Auto Research (NVIDIA/skills, 3.5k stars), Git Revert Safety (ZaxbyHub/opencode-swarm, 493 stars), Finishing a Development Branch (obra/superpowers, 297k stars) and Code Design Rationale Investigator (cursor/plugins, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ghostty Submodule and GhosttyKit Workflow?

manaflow-ai (a GitHub organization) maintains it in manaflow-ai/cmux, which has 28,044 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on October 9, 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.