Menu
Idiomatic fish shell scripting and config — functions, completions, abbreviations, conf.d, argparse. Use when editing .fish files or anything under ~/.config/fish.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Browser automation CLI wrapping Playwright for one-shot tasks like navigation, page interaction, screenshots, and scraping. Use when driving a live browser from the terminal. Skip for repeat automations that warrant a full Playwright script.
Author and maintain agent context markdown — AGENTS.md, rules, skills, memory files. Use when creating, editing, or refactoring any agent-focused doc, or after major codebase exploration to capture learning.
Author and audit Agent Skills. Use when creating a new skill, refactoring an existing one, or rewriting skill metadata (name, description, allowed-tools).
Build ASCII/Unicode animations such as loading spinners, logo reveals, particle effects, and terminal art. Covers character grids, frame loops, per-character state machines, ordering, and performance. Use when designing any character-based visual animation.
Run tests, builds, migrations, or any command needing real CI secrets/services on Blacksmith. Use when testing or validating code, or before any commit or push that should be verified against CI.
Use when editing files in a Bun project (bun.lock or bun.lockb at the root, a packageManager field set to bun in package.json, or imports from the bun namespace) or running bun/bunx commands. Covers Bun-native APIs, the bun test runner, bun build --compile, and the Bun-optimized tsconfig.
| name | fish-shell |
| description | Idiomatic fish shell scripting and config — functions, completions, abbreviations, conf.d, argparse. Use when editing .fish files or anything under ~/.config/fish. |
Fish is not bash. Different syntax (test over [[ ]], (cmd) over $(cmd)), string/math builtins, scopes via set -l/-g/-gx/-U, and no &&/|| — use ; and/; or or chained commands.
~/.config/fish/ (chezmoi source: private_dot_config/fish/)functions/<name>.fish — autoloaded on first use; filename must match function nameconf.d/*.fish — sourced at startup; abbreviations, keybindings, env tweakscompletions/<cmd>.fish — completion definitionsconfig.fish — assembled from .chezmoitemplates/fish/*.fish fragments at chezmoi apply time. See chezmoi skill for the assembly model.You're in bash. Run fish via subshell: fish -c "<commands>". New .fish files are picked up automatically by each new subshell after chezmoi apply — no reload needed. Shell side effects can be destructive, so prefer asking the user to test interactive features rather than self-validating.
logirl — preferred for all structured messagesgum — confirms, inputs, choosers| Bash | Fish |
|---|---|
[[ ... ]] | test ... |
$(command) | (command) |
VAR=value | set VAR value |
export VAR=value | set -gx VAR value |
command -v cmd | type -q cmd |
$((1+2)) | math 1+2 |
${var:-default} | set -q var; or set var default |
"${arr[@]}" | $arr |
${#var} | string length $var |
cmd1 && cmd2 | cmd1; and cmd2 |
cmd1 || cmd2 | cmd1; or cmd2 |
source file | source file or . file |
Fish shell docs — fetch when something isn't covered locally.