skills.rest
gwenwindflower
gwenwindflowerCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

fish-shell

Automate idiomatic Fish shell scripting and configuration under ~/.config/fish.

9|Updated Feb 15, 2026
Search Tags:#config#scripting#argparse#error-handling#fish#fish-shell
One-click install
npx skills add https://github.com/gwenwindflower/dotfiles --skill fish-shell-gwenwindflower
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fish-shell
Source: https://github.com/gwenwindflower/dotfiles/tree/main/dot_agents/exact_skills/fish-shell
Command: npx skills add https://github.com/gwenwindflower/dotfiles --skill fish-shell-gwenwindflower

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps developers write clean, idiomatic Fish shell scripts and manage their Fish configuration, reducing errors and increasing consistency.

Core Features & Use Cases

  • Provides clear patterns for defining Fish functions with argparse, startup configuration, and autocomplete rules.
  • Includes guidance for using conf.d, function autoloads, and completions to improve developer productivity.
  • Demonstrates practical use cases like building modular Fish configs, consistent error handling with logirl, and interactive prompts with gum.

Quick Start

Describe how to set up a baseline Fish config and begin writing idiomatic Fish functions, completions, and config under ~/.config/fish.

Frequently Asked Questions about fish-shell

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write idiomatic Fish shell scripts with argparse?▼

Idiomatic Fish shell scripting uses the built-in argparse command to parse options. You define functions with standard Fish patterns, handling errors via conventions like logirl to ensure clean, consistent script execution.

What is the best way to organize Fish shell configuration and startup files?▼

Organize Fish shell configuration by editing ~/.config/fish. Use the conf.d directory for startup scripts that run on launch, and separate autoloaded functions into their own files to improve developer productivity.

How do I create autocomplete rules for custom Fish shell functions?▼

Create Fish completions by defining autocomplete rules in the ~/.config/fish/completions directory. This allows the shell to automatically load and suggest arguments for your custom functions during interactive use.

Can I use interactive prompts in Fish shell scripts with gum?▼

Yes, Fish shell scripts support optional integration with tools like gum. You can build interactive prompts directly into your scripts and functions, enhancing user input handling alongside argparse.

Why use abbreviations instead of aliases in Fish shell config?▼

Fish abbreviations expand inline as you type, showing the full command before execution. Configuring them in your Fish config provides transparent, editable command shortcuts compared to traditional aliases.

Related Skills

Explore More Software Engineering Skills→
notquenotque
415

fish-shell-config

Configure Fish shell with modular conf.d and functions directories.

Community
Advanced
dragoscirjandragoscirjan

lang-fish

Standardize Fish shell scripting with Fish-native variables, argparse, and status codes.

Community
Basic
benjaminwesternbenjaminwestern
3

terminal-ui-engineer

Engineer interactive terminal UIs in shell scripts using Charmbracelet's Gum.

Community
Advanced
LuisSambranoLuisSambrano
7

posix-pro

Write strict POSIX sh scripts for portability across Unix-like systems.

Community
Advanced