mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-19 02:17:09 +00:00
- Slim README from 777 to 214 lines for better readability - Adjust value prop: emphasize sync, bidirectional, team over AI-native - Split detailed content into docs/ directory: - install.md: init, install, update, upgrade, uninstall - sync.md: sync, pull, push, backup, restore with diagrams - targets.md: target management with flowcharts - cross-machine.md: multi-machine sync setup - team-edition.md: tracked repos, nested skills, team sharing - configuration.md: config file reference - faq.md: doctor command, FAQ, troubleshooting - Add docs/README.md as documentation index - Remove /docs/ from .gitignore
4.4 KiB
4.4 KiB
Configuration
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
| Value | Behavior |
|---|---|
merge |
Each skill symlinked individually. Local skills preserved. (default) |
symlink |
Entire 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
Auto-Detected Targets
When running skillshare init, these paths are checked:
| Target | Path |
|---|---|
| amp | ~/.amp/skills |
| claude | ~/.claude/skills |
| codex | ~/.codex/skills |
| crush | ~/.crush/skills |
| cursor | ~/.cursor/skills |
| gemini | ~/.gemini/skills |
| copilot | ~/.github-copilot/skills |
| goose | ~/.goose/skills |
| letta | ~/.letta/skills |
| antigravity | ~/.antigravity/skills |
| opencode | ~/.opencode/skills |
Only paths that exist are added as targets.
Environment Variables
| Variable | Description |
|---|---|
SKILLSHARE_CONFIG |
Override config file path |
SKILLSHARE_SOURCE |
Override source directory |
Example:
SKILLSHARE_CONFIG=~/custom-config.yaml skillshare status
Skill Metadata
Each skill can have a .skillshare.yaml file storing install metadata:
# ~/.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.
Related
- targets.md — Managing targets
- sync.md — Sync modes explained
- faq.md — Troubleshooting