ASCII box-drawing characters (┌─┐│└─┘) render inconsistently on
Windows due to monospace font width differences. Replace all 30+
diagrams across docs with Mermaid flowcharts rendered as SVG.
- Add Mermaid handDrawn config (Rough.js sketchy style, seed 42)
- Add CSS fix for foreignObject overflow clipping in handDrawn mode
- Convert supported-targets grid to HTML with anchor navigation
- Simplify all node labels to short, readable single-line text
- Strip redundant %%{init}%% directives (covered by global config)
5.7 KiB
sidebar_position
| sidebar_position |
|---|
| 4 |
list
List all installed skills in the source directory.
skillshare list # Compact view
skillshare list --verbose # Detailed view
When to Use
- See what skills are installed and where they came from
- Check which skills are tracked repos vs local
- Audit your skill collection before a cleanup
Example Output
Compact View
Skills are automatically grouped by directory when you use folders to organize them:
Installed skills
─────────────────────────────────────────
frontend/
→ react-helper github.com/user/skills
→ vue-helper github.com/user/skills
→ my-skill local
→ commit-commands github.com/user/skills
Tracked repositories
─────────────────────────────────────────
✓ _team-skills 3 skills, up-to-date
If all skills are at the top level (no folders), the output is a flat list — identical to previous versions.
Verbose View
skillshare list --verbose
Installed skills
─────────────────────────────────────────
frontend/
react-helper
Source: github.com/user/skills
Type: github
Installed: 2026-01-15
vue-helper
Source: github.com/user/skills
Type: github
Installed: 2026-01-15
my-skill
Source: (local - no metadata)
commit-commands
Source: github.com/user/skills
Type: github
Installed: 2026-01-15
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:
flowchart TD
subgraph GLOBAL["GLOBAL"]
G_SRC["~/.config/skillshare/skills/"]
G_CMD["list / list -g"]
G_CMD --> G_SRC
end
subgraph PROJECT["PROJECT"]
P_SRC[".skillshare/skills/"]
P_CMD["list -p"]
P_CMD --> P_SRC
end
| 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:
flowchart LR
CMD["skillshare list"] --> CHECK{".skillshare/config.yaml exists?"}
CHECK -- YES --> PROJ["Project mode"]
CHECK -- NO --> GLOB["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)
─────────────────────────────────────────
tools/
→ pdf anthropic/skills/pdf
→ review github.com/team/tools
→ my-skill local
→ 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 grouped by directory and 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 |
Directory Grouping
When skills are organized into folders (via --into during install or manual mv + sync), list automatically groups them by directory:
frontend/
→ react-helper github.com/user/skills
→ vue-helper github.com/user/skills
→ my-skill local
- Skills under the same folder share a group header (e.g.,
frontend/) - Within each group, only the base name is shown (not the full path)
- Top-level skills (no parent folder) appear ungrouped at the bottom
- If all skills are top-level, the output is a flat list — no group headers
Grouping is based on the directory structure inside your source directory, not a flag. To start using it, organize skills with --into:
skillshare install owner/repo -s react-patterns --into frontend
skillshare install owner/repo -s vue-patterns --into frontend
For more details, see Organizing Skills with Folders.
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 |
