fish-shell-config

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

415|44|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/notque/claude-code-toolkit --skill fish-shell-config-notque
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fish-shell-config
Source: https://github.com/notque/claude-code-toolkit/tree/main/skills/fish-shell-config
Command: npx skills add https://github.com/notque/claude-code-toolkit --skill fish-shell-config-notque

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Modular Fish shell configuration reduces setup time, prevents common misconfigurations, and makes maintenance easier by separating concerns across files.

Core Features & Use Cases

  • Modular structure with conf.d/ and functions/ to organize PATH, environment variables, and shortcuts.
  • Interactive guards for abbreviations and integrations, plus Fish-specific syntax (set, test, fish_add_path) to ensure compatibility.
  • Easy migration paths from Bash or other shells using references in references/ to guide translation and modernization.

Quick Start

Configure a minimal, modular Fish config using conf.d/, functions/, and references in your ~/.config/fish/.

Frequently Asked Questions about fish-shell-config

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

FAQPage Schema
How do I structure a modular Fish shell configuration?

Structure a modular Fish shell configuration by separating concerns across conf.d/ for environment variables and PATH, and functions/ for autoloaded commands. This isolates settings into maintainable files, preventing common misconfigurations in interactive shells.

What is the best way to manage PATH and environment variables in Fish?

Manage PATH and environment variables in Fish using Fish-native syntax like set and fish_add_path within modular conf.d/ files. This approach isolates path management safely and prevents unintended execution in non-interactive shells.

How do I migrate my Bash configuration to Fish shell?

Migrate a Bash configuration to Fish shell by using reference guides to translate existing settings into Fish-native syntax. The modular setup isolates environment variables and functions, easing modernization from other shells.

Why do my Fish abbreviations run in non-interactive scripts?

Fish abbreviations may run in non-interactive scripts if they lack interactive guards. Applying interactive guards to abbreviations and tool integrations prevents unintended execution during automated or non-interactive shell sessions.

Can I autoload custom commands in a modular Fish setup?

You can autoload custom commands by placing them in the functions/ directory of your Fish configuration. This modular structure separates shortcuts and commands from environment variables for robust, maintainable setups.

When should I use conf.d in Fish shell?

Use conf.d in Fish shell when you need modular loading for environment variables and PATH management. It isolates configuration concerns into separate files, targeting interactive shells and developer environments safely.