Configuration

Config File Location

skillshub stores its configuration in a TOML file at:

~/.config/skillshub/config.toml

This file is created automatically the first time you run skillshub init. You can also create or edit it manually.

Configuration Options

default_agent

Set the default agent used by the link command. When set, you can omit the --agent flag.

default_agent = "claude"

# Without default_agent, you must specify:
skillshub link commit-helper --agent claude

# With default_agent = "claude", this is equivalent:
skillshub link commit-helper

taps

A list of configured taps (GitHub repositories acting as skill registries). The default tap skillshub/core is always included.

taps = [
  "skillshub/core",
  "github.com/myorg/our-skills",
  "github.com/user/personal-skills"
]

Taps are searched in the order listed. You can also manage taps via the CLI:

skillshub tap add github.com/user/my-tap
skillshub tap remove github.com/user/my-tap
skillshub tap list

install_dir

Override the default directory where skills are downloaded and stored.

install_dir = "/home/user/.local/share/skillshub/skills"

The default location is ~/.local/share/skillshub/skills on Linux/macOS and %LOCALAPPDATA%\skillshub\skills on Windows.

auto_link

When set to true, skillshub automatically links a skill to the default agent immediately after installation. Defaults to false.

auto_link = true

With this enabled, skillshub install commit-helper will both install the skill and link it to the agent specified by default_agent.

Agent-Specific Configuration Paths

Each supported agent stores its skills in a specific directory. When you run skillshub link, the skill is symlinked or copied into the appropriate path for that agent.

Agent	Skills Directory
Claude	~/.claude/skills/
Cursor	~/.cursor/skills/
Continue	~/.continue/skills/
Codex	~/.codex/skills/
Aider	~/.aider/skills/
OpenCode	~/.opencode/skills/
Trae	~/.trae/skills/

These paths are the defaults. If an agent uses a non-standard configuration directory, skillshub will attempt to detect it automatically. You can also override agent paths in the config file:

[agent_paths]
claude = "/custom/path/to/claude/skills"
cursor = "/custom/path/to/cursor/skills"

Environment Variables

skillshub respects the following environment variables. They take precedence over values in the config file.

SKILLSHUB_HOME

Override the base directory for all skillshub data (installed skills, cache, and metadata).

export SKILLSHUB_HOME="/opt/skillshub"

Default: ~/.local/share/skillshub

SKILLSHUB_CONFIG

Override the path to the configuration file.

export SKILLSHUB_CONFIG="/etc/skillshub/config.toml"

Default: ~/.config/skillshub/config.toml

Example Config File

A complete config.toml with all options:

# Default agent for link commands
default_agent = "claude"

# Auto-link skills to the default agent after install
auto_link = true

# Custom install directory (optional)
# install_dir = "/home/user/.local/share/skillshub/skills"

# Configured taps (searched in order)
taps = [
  "skillshub/core",
  "github.com/myorg/company-skills",
  "github.com/user/my-skills"
]

# Override agent skill directories (optional)
[agent_paths]
claude = "~/.claude/skills/"
cursor = "~/.cursor/skills/"
continue = "~/.continue/skills/"

To verify your current configuration:

skillshub config list

To set a single value from the CLI:

skillshub config set default_agent cursor
skillshub config set auto_link true