菜单
Run one-off Linux CLI tools from nixpkgs without installing them globally. Use when a task hits command-not-found or missing executable errors, or when an ephemeral tool should be run via `nix run` (or comma) instead of adding system dependencies.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Guidance for Worktrunk (the `wt` CLI) — git worktree management, hooks, and config. Load when editing .config/wt.toml or ~/.config/worktrunk/config.toml; adding, modifying, or debugging hooks (post-merge, post-start, pre-commit, pre-merge, post-switch, etc.); configuring commit message generation or command aliases; or troubleshooting wt behavior. Also answers general worktrunk/wt questions.
Use when a repository contains a `justfile` or `.justfile` and work should flow through `just` recipes instead of ad-hoc shell commands. Covers recipe discovery, execution, debugging, and concise recipe authoring/refactoring for repeatable project tasks.
Break a plan, spec, or PRD into independently-grabbable issues on the project issue tracker using tracer-bullet vertical slices.
Offer optional 10-15 minute deliberate learning exercises during AI-assisted coding. Use when the user asks for a learning opportunity, deliberate practice, retrieval check-in, prediction exercise, teach-back, or when substantial work created a good moment to offer learning. Do not use for ordinary implementation unless the user explicitly wants learning.
Write effective pull request description bodies that explain what changed, why it changed, reviewer focus, validation, and risk. Use when creating, reviewing, or improving PR descriptions for internal work, OSS contributions, infra changes, migrations, or WIP requests for early feedback.
Write and edit substantial human-facing prose with clear, concise technical style while preserving the user's canonical voice from `~/.config/opencode/TONE.md`. Use for documentation, README prose, PR descriptions, commit-message bodies, changelog notes, issue summaries, long-form explanations, UI/help text, error messages, and copyediting drafts for clarity, concision, structure, tone, and tradeoffs.
| name | nix-run |
| description | Run one-off Linux CLI tools from nixpkgs without installing them globally. Use when a task hits command-not-found or missing executable errors, or when an ephemeral tool should be run via `nix run` (or comma) instead of adding system dependencies. |
command -v <exe>.nixos_nix (action=search, source=nixos, type=packages) when available in the current toolbox sessionnix search nixpkgs <term>nix run nixpkgs#<pkg> -- <args>.nix run for ephemeral execution only. Do not install packages or edit system/user package config.nix run nixpkgs#<pkg> -- ....-- before tool arguments.bash -lc wrappers. Shell wrapping often mutates quoting/escaping and makes failures harder to trace.rm -rf, partitioning, firewall rewrites, privilege changes) unless explicitly requested. nix run lowers install risk, not runtime command risk.# Generic pattern
nix run nixpkgs#<pkg> -- <command-args>
# Example: yt-dlp one-off usage
nix run nixpkgs#yt-dlp -- --version
# Example: ffmpeg one-off usage
nix run nixpkgs#ffmpeg -- -version
attribute ... not found), try one correction pass:
nixos_nix when available, otherwise nix search nixpkgs <term>| Symptom | Likely cause | Next action |
|---|---|---|
attribute 'X' not found | wrong package attribute | use nixos_nix package lookup when available, otherwise nix search nixpkgs <term>; pick closest exact attr and retry once |
command not found after nix run | package entrypoint differs from package name | rerun with explicit command if needed: nix run nixpkgs#<pkg> -- <actual-binary> ... |
| immediate argument parse failure | wrong argument shape for wrapped tool | keep package, minimally adjust args only, retry once |
| interactive prompt blocks execution | command expects TTY/user input | rerun with non-interactive flags or stop and request explicit user input intent |
nix run command used.