菜单
Use when working with carapace shell completion — integrating into CLIs, writing YAML specs, creating custom actions, looking up macros, setting up shell completion, configuring choices/bridges, using the MCP server, or adding man page documentation.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when working with QEMU — qemu-system-*, qemu-img, qemu-nbd, qemu-storage-daemon, qemu-pr-helper, block drivers, machine types, CPU models, device emulation, networking, display options, QMP protocol, and guest agent. Triggers on: "qemu", "qemu-system", "qemu-img", "qemu-nbd", "qemu-kvm", "QEMU", "qcow2", "qcow", "qed", "virtio", "virgl", "vhost-user", "VirtIO", "block driver", "machine type", "SEV", "SEV-SNP", "TDX", "snapshot", "backing file", "NBD", "Network Block Device", "QMP", "QEMU Monitor Protocol", "guest agent", "qemu-ga", "cpu model", "host passthrough", "SPICE", "VNC".
Use when working with Homebrew (`brew`) — the package manager for macOS and Linux. Covers the command structure, formula and cask DSLs, taps, bottles, the Cellar, services, bundle/Brewfile, environment variables, installation internals, and developer commands. Triggers on: "brew", "homebrew", "brew install", "brew uninstall", "brew update", "brew upgrade", "brew search", "brew tap", "brew cask", "brew bottle", "brew services", "brew bundle", "brew cleanup", "brew doctor", "brew audit", "brew livecheck", "brew test-bot", "brew bump-formula-pr", "Brewfile", "HOMEBREW_PREFIX", "HOMEBREW_CELLAR", "HOMEBREW_NO_INSTALL_FROM_API", "HOMEBREW_CASK_OPTS", "HOMEBREW_BOTTLE_DOMAIN", "Formula", "Cask", "Cellar", "Caskroom", "keg", "rack", "tap", "bottle", "superenv", "Formulary", "FormulaInstaller", "shellenv", "restart_service", "keg-only", "brew deps", "brew uses", "brew leaves", "brew outdated", "brew pin", "brew fetch", "brew create", "brew edit", "livecheck", "auto_updates", "depends_on".
Use when working with the cargo CLI — Rust's package manager. Covers the manifest format (Cargo.toml), dependencies, features, workspaces, build profiles, build scripts, configuration (.cargo/config.toml), registries and publishing, environment variables, the lockfile and cache, and the command reference. Triggers on: "cargo", "cargo build", "cargo check", "cargo test", "cargo run", "cargo add", "cargo update", "cargo publish", "cargo new", "cargo init", "cargo install", "cargo doc", "cargo bench", "cargo tree", "cargo metadata", "Cargo.toml", "Cargo.lock", "crate", "workspace", "feature", "profile", "build script", "build.rs", "registry", "crates.io", "CARGO_HOME", "rustc", "rustdoc", "rust-version", "edition".
Use when working with the GitHub CLI (`gh`) — authentication, repositories, pull requests, issues, releases, GitHub Actions (workflows, runs, caches), the gh API command, extensions, secrets and variables, search, gists, SSH/GPG keys, labels, rulesets, codespaces, browsing, configuration, aliases, JSON output formatting, and environment variables. Triggers on: "gh", "gh auth", "gh repo", "gh pr", "gh issue", "gh release", "gh run", "gh workflow", "gh api", "gh extension", "gh secret", "gh variable", "gh search", "gh gist", "gh label", "gh codespace", "gh browse", "gh status", "gh config", "gh alias", "gh completion", "gh ssh-key", "gh gpg-key", "gh ruleset", "gh cache", "gh org", "GH_TOKEN", "GH_REPO", "GH_HOST", "gh pr create", "gh pr checkout", "gh pr merge", "gh repo clone", "gh repo create", "gh issue create", "gh release create", "gh workflow run", "gh run list", "gh api graphql", "gh extension install", "gh secret set", "gh search repos".
Use when working with the Go CLI (go command) — building, testing, modules, workspaces, environment, toolchain, generate, vet, coverage, profiling, fuzzing, cross-compilation, and internal tool commands. Triggers on: "go", "go build", "go test", "go mod", "go work", "go generate", "go vet", "go tool", "go get", "go install", "go run", "go clean", "go list", "go env", "go doc", "go fmt", "go fix", "go version", "go telemetry", "GOMODCACHE", "GOPROXY", "GOSUMDB", "GOPRIVATE", "GOTOOLCHAIN", "GOOS", "GOARCH", "CGO_ENABLED", "build constraint", "build tag", "go.mod", "go.sum", "go.work", "vendor", "pprof", "cover", "test2json", "buildjson", "GODEBUG", "GOEXPERIMENT", "minimal version selection", "MVS", "module proxy", "toolchain", "fuzzing", "race detector".
Use when working with the jq command-line JSON processor — filters, builtins, operators, path expressions, assignments, variables, functions, regex, format strings, dates, modules, invocation flags, and exit codes. Triggers on: "jq", "jq filter", "jq program", "jq query", "jq language", "jq manual", "jq builtin", "jq regex", "jq module", "jq reduce", "jq foreach", "jq select", "jq walk", "jq recurse", "jq map", "jq inputs", "jq slurp", "jq --arg", "jq --argjson", "jq --null-input", "jq --raw-output", "jq @base64", "jq @csv", "jq @sh", "jq @uri", "jq tojson", "jq fromjson", "jq todate", "jq fromdate", "jq strptime", "jq strftime", "jq now", "jq $ENV", "jq env", "jq getpath", "jq setpath", "jq del", "jq paths", "jq sort", "jq group_by", "jq sub", "jq gsub", "jq test", "jq match", "jq with_entries", "jq map_values", "jq modulemeta", "jq import", "jq input", "jq --stream", "jq --exit-status", "jq --compact-output", "jq //", "jq destructuring", "jq label", "jq break", "jq try", "jq catch", "jq INDEX", "jq JOIN".
| name | carapace |
| description | Use when working with carapace shell completion — integrating into CLIs, writing YAML specs, creating custom actions, looking up macros, setting up shell completion, configuring choices/bridges, using the MCP server, or adding man page documentation. |
| user-invocable | true |
Reference for using carapace shell completion — integrating into CLIs, writing specs, creating actions, and configuring completions.
Load the reference that matches your task. When in doubt, load multiple references.
| Keywords | Reference |
|---|---|
| Integrate carapace, cobra, PreRun, PreInvoke, bridge, standalone mode, flag config, non-POSIX flags | references/integrate.md |
| Custom actions, ActionValues, ActionCallback, ActionExecCommand, modifiers, naming, caching, batch, MultiParts, UID, tags | references/action.md |
| YAML spec, user spec, flags, subcommands, parsing modes, completion, macros, modifiers, runnable specs | references/spec.md |
| Macro format, MacroN, MacroI, MacroV, $files, macro signatures, modifier chaining | references/macro.md |
| Choices, variants, bridges, CARAPACE_BRIDGES, --choice, --list, group priority | references/choice.md |
| Setup, shell integration, environment variables, overlays, extensions, install | references/setup.md |
| Environment variable completion, env YAML, conditions, ActionNames, ActionValues | references/env.md |
| Convert spec to Go, codegen, macro-to-Go mapping, modifier translation | references/convert.md |
| Update existing completer, incremental update, new flags, new subcommands, surgical edits | references/update.md |
| Scrape spec, generate from source, Docker, supported frameworks, patch-and-container | references/scrape.md |
| MCP server, complete tool, list_macros tool, codegen tool, JSON-RPC, stdio transport | references/mcp.md |
| Man pages, carapace-man, UID documentation, YAML man pages, inline descriptions, scheme, host, path | references/man.md |
For internal library development (Action API internals, traverse engine, shell formatters, style system), use the carapace-dev skill (in the carapace repo).
