Skip to main content

Configuration

Configuration file reference for skillshare.

Overview​

┌─────────────────────────────────────────────────────────────────┐
│                    SKILLSHARE FILES                             │
│                                                                 │
│  ~/.config/skillshare/                                          │
│  ├── config.yaml          ← Configuration file                  │
│  ├── skills/              ← Source directory (your skills)      │
│  │   ├── my-skill/                                              │
│  │   ├── another/                                               │
│  │   └── _team-repo/      ← Tracked repository                  │
│  └── backups/             ← Automatic backups                   │
│      └── 2026-01-20.../                                         │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Config File​

Location: ~/.config/skillshare/config.yaml

Full Example​

# Source directory (where you edit skills)
source: ~/.config/skillshare/skills

# Default sync mode for new targets
mode: merge

# Targets (AI CLI skill directories)
targets:
  claude:
    path: ~/.claude/skills
    # mode: merge (inherits from default)

  codex:
    path: ~/.codex/skills
    mode: symlink  # Override default mode

  cursor:
    path: ~/.cursor/skills

  # Custom target
  myapp:
    path: ~/apps/myapp/skills

# Files to ignore during sync
ignore:
  - "**/.DS_Store"
  - "**/.git/**"
  - "**/node_modules/**"
  - "**/*.log"

Fields​

source​

Path to your skills directory (single source of truth).

source: ~/.config/skillshare/skills

Default: ~/.config/skillshare/skills

mode​

Default sync mode for all targets.

mode: merge
ValueBehavior
mergeEach skill symlinked individually. Local skills preserved. (default)
symlinkEntire target directory is one symlink.

targets​

AI CLI skill directories to sync to.

targets:
  <name>:
    path: <path>
    mode: <mode>  # optional, overrides default

Example:

targets:
  claude:
    path: ~/.claude/skills

  codex:
    path: ~/.codex/skills
    mode: symlink

  custom:
    path: ~/my-app/skills

ignore​

Glob patterns for files to skip during sync.

ignore:
  - "**/.DS_Store"
  - "**/.git/**"
  - "**/node_modules/**"

Default patterns:

  • **/.DS_Store
  • **/.git/**

Managing Config​

View current config​

skillshare status
# Shows source, targets, modes

Edit config directly​

# Open in editor
$EDITOR ~/.config/skillshare/config.yaml

# Then sync to apply changes
skillshare sync

Reset config​

rm ~/.config/skillshare/config.yaml
skillshare init

Environment Variables​

VariableDescription
SKILLSHARE_CONFIGOverride config file path
GITHUB_TOKENFor API rate limit issues

Example:

SKILLSHARE_CONFIG=~/custom-config.yaml skillshare status

Skill Metadata​

When you install a skill, skillshare creates a .skillshare.yaml file:

# ~/.config/skillshare/skills/pdf/.skillshare.yaml
source: github.com/anthropics/skills/skills/pdf
installed_at: 2026-01-20T15:30:00Z
type: git

This is used by skillshare update to know where to fetch updates from.

Don't edit this file manually.

Platform Differences​

macOS / Linux​

source: ~/.config/skillshare/skills
targets:
  claude:
    path: ~/.claude/skills

Uses symlinks.

Windows​

source: %USERPROFILE%\.config\skillshare\skills
targets:
  claude:
    path: %USERPROFILE%\.claude\skills

Uses NTFS junctions (no admin required).