Extras source dir is under extras/ subdirectory (~/.config/skillshare/extras/<name>/), not directly under the config root. Also, sync extras and the extras config field both support project mode — removed incorrect "global only" admonitions. - extras.md: fix source path references and example output - sync.md: replace global-only admonition, fix directory structure diagram - configuration.md: fix source path, add extras/ to overview tree - index.md: add Extras Management category with extras command
4.5 KiB
sidebar_position
| sidebar_position |
|---|
| 2 |
extras
Manage non-skill resources (rules, commands, prompts, etc.) that are synced alongside skills.
Overview
Extras are additional resource types managed by skillshare — think of them as "skills for non-skill content." Common use cases include syncing AI rules, editor commands, or prompt templates across tools.
Each extra has:
- A name (e.g.,
rules,prompts,commands) - A source directory under
~/.config/skillshare/extras/<name>/(global) or.skillshare/extras/<name>/(project) - One or more targets where files are synced to
Commands
extras init
Create a new extra resource type.
# Interactive wizard
skillshare extras init
# CLI flags
skillshare extras init <name> --target <path> [--target <path2>] [--mode <mode>]
Options:
| Flag | Description |
|---|---|
--target <path> |
Target directory path (repeatable) |
--mode <mode> |
Sync mode: merge (default), copy, or symlink |
--project, -p |
Create in project config (.skillshare/) |
--global, -g |
Create in global config |
Examples:
# Sync rules to Claude and Cursor
skillshare extras init rules --target ~/.claude/rules --target ~/.cursor/rules
# Project-scoped extra with copy mode
skillshare extras init prompts --target .claude/prompts --mode copy -p
extras list
List all configured extras and their sync status.
skillshare extras list [--json] [-p|-g]
Output columns:
- Source directory and file count
- Per-target: path, mode, and sync status (
synced,drift,not synced,no source)
Example output:
$ skillshare extras list
Rules ~/.config/skillshare/extras/rules/ (2 files)
✔ ~/.claude/rules merge synced
✔ ~/.cursor/rules copy synced
Prompts ~/.config/skillshare/extras/prompts/ (1 file)
✔ ~/.claude/prompts merge synced
extras remove
Remove an extra from configuration.
skillshare extras remove <name> [--force] [-p|-g]
Source files and synced targets are not deleted — only the config entry is removed.
extras collect
Collect local files from a target back into the extras source directory. Files are copied to source and replaced with symlinks.
skillshare extras collect <name> [--from <path>] [--dry-run] [-p|-g]
Options:
| Flag | Description |
|---|---|
--from <path> |
Target directory to collect from (required if multiple targets) |
--dry-run |
Show what would be collected without making changes |
Example:
# Collect rules from Claude back to source
skillshare extras collect rules --from ~/.claude/rules
# Preview what would be collected
skillshare extras collect rules --from ~/.claude/rules --dry-run
Sync Modes
| Mode | Behavior |
|---|---|
merge (default) |
Per-file symlinks from target to source |
copy |
Per-file copies |
symlink |
Entire directory symlink |
Directory Structure
~/.config/skillshare/
├── config.yaml # extras config lives here
├── skills/ # skill source
└── extras/ # extras source root
├── rules/ # extras/rules/ source files
│ ├── coding.md
│ └── testing.md
└── prompts/
└── review.md
Configuration
In config.yaml:
extras:
- name: rules
targets:
- path: ~/.claude/rules
- path: ~/.cursor/rules
mode: copy
- name: prompts
targets:
- path: ~/.claude/prompts
Syncing
Extras are synced with:
skillshare sync extras # sync extras only
skillshare sync --all # sync skills + extras together
See sync extras for full sync documentation including --json, --dry-run, and --force options.
Workflow
# 1. Create a new extra
skillshare extras init rules --target ~/.claude/rules --target ~/.cursor/rules
# 2. Add files to the source directory
# (edit ~/.config/skillshare/extras/rules/coding.md)
# 3. Sync to targets
skillshare sync extras
# 4. List status
skillshare extras list
# 5. Collect a file edited in a target back to source
skillshare extras collect rules --from ~/.claude/rules
See Also
- sync — Sync extras to targets
- status — Show extras file and target counts
- Configuration — Extras config reference