mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-19 02:17:09 +00:00
Allow project targets to set mode individually (merge or symlink), mirroring global behavior. Default remains merge. - Add Mode field to ProjectTargetEntry with YAML marshal/unmarshal - Add mode branching in project sync (reuses syncMergeMode/syncSymlinkMode) - Support --mode flag in target info for project targets - Mode-aware unlink in target remove - Unify project sync UI with global sync output format - Update docs to reflect per-target mode support
5.6 KiB
5.6 KiB
sidebar_position
| sidebar_position |
|---|
| 4 |
list
List all installed skills in the source directory.
skillshare list # Compact view
skillshare list --verbose # Detailed view
Example Output
Compact View
Installed skills
─────────────────────────────────────────
→ my-skill local
→ commit-commands github.com/user/skills
→ _team-skills:review tracked: _team-skills
Tracked repositories
─────────────────────────────────────────
✓ _team-skills 3 skills, up-to-date
Verbose View
skillshare list --verbose
Installed skills
─────────────────────────────────────────
my-skill
Source: (local - no metadata)
commit-commands
Source: github.com/user/skills
Type: github
Installed: 2026-01-15
_team-skills:review
Tracked repo: _team-skills
Source: github.com/team/skills
Type: github
Installed: 2026-01-10
Tracked repositories
─────────────────────────────────────────
✓ _team-skills 3 skills, up-to-date
! _other-repo 5 skills, has changes
Global vs Project
Skillshare operates at two levels. The list command shows skills from the active level:
┌─────────────────────────────────────────────────────────────┐
│ GLOBAL (machine-wide) PROJECT (repository-scoped) │
│ │
│ ~/.config/skillshare/ <project>/.skillshare/ │
│ └── skills/ └── skills/ │
│ ├── my-skill/ ├── local-skill/ │
│ ├── commit-cmds/ └── remote-skill/ │
│ └── _team-repo/ │
│ │
│ ┌───────────────┐ ┌───────────────┐ │
│ │ list / list -g│ │ list -p │ │
│ └───────┬───────┘ └───────┬───────┘ │
│ ▼ ▼ │
│ Installed skills Installed skills (project) │
│ ───────────────── ────────────────────────── │
│ → my-skill local → local-skill local │
│ → commit.. github.com/... → remote-skill github.com/ │
└─────────────────────────────────────────────────────────────┘
| Global | Project | |
|---|---|---|
| Source | ~/.config/skillshare/skills/ |
.skillshare/skills/ |
| Flag | -g or default |
-p or auto-detected |
| Scope | All projects on machine | Single repository |
| Shared via | push / pull |
git commit |
Auto-Detection
When you run skillshare list without flags, skillshare automatically detects the mode:
skillshare list
│
├── .skillshare/config.yaml exists?
│ ├── YES → Project mode
│ └── NO → Global mode
cd my-project/ # Has .skillshare/config.yaml
skillshare list # → Installed skills (project)
cd ~
skillshare list # → Installed skills (global)
Use -p or -g to override auto-detection:
skillshare list -g # Force global, even inside a project
skillshare list -p # Force project, even without auto-detection
Project Mode
skillshare list # Auto-detected if .skillshare/ exists
skillshare list -p # Explicit project mode
Example Output
Installed skills (project)
─────────────────────────────────────────
→ my-skill local
→ pdf anthropic/skills/pdf
→ review github.com/team/tools
→ 3 skill(s): 2 remote, 1 local
Project list uses the same visual format as global list, with (project) label in the header. Skills are categorized as local (no metadata) or by source URL (remote).
Options
| Flag | Description |
|---|---|
--verbose, -v |
Show detailed information (source, type, install date) |
--project, -p |
List project skills |
--help, -h |
Show help |
Understanding the Output
Skill Sources
| Label | Meaning |
|---|---|
local |
Created locally, no metadata |
github.com/... |
Installed from GitHub |
tracked: <repo> |
Part of a tracked repository |
Repository Status
| Icon | Meaning |
|---|---|
✓ |
Up-to-date, no local changes |
! |
Has uncommitted changes |
