Hub index, built-in search, and draft candidates discovered only the source path, dropping the follow policy used by the inventory. Add optional walk options to the shared Hub functions and pass the operation policy from dashboard handlers and CLI indexing. Explicit CLI sources use the active config policy while retaining configuration-free indexing. Cover global/project modes, enabled/disabled following, all three handlers, and CLI source overrides; document the behavior in all website locales and built-in guidance.
7.0 KiB
sidebar_position
| sidebar_position |
|---|
| 8 |
hub
Manage skill hubs — saved hub sources for organization-wide skill discovery.
When to Use
- Set up your organization's skill catalog for
searchto query - Switch between multiple hubs (e.g., company-wide vs team-specific)
- List or remove saved hub sources
hub add
Save a hub source to config for reuse in search --hub.
skillshare hub add <url> [options]
| Flag | Description |
|---|---|
--label, -l |
Custom label (default: derived from URL hostname) |
--project, -p |
Save to project config |
--global, -g |
Save to global config |
The first hub added is automatically set as the default. Labels are case-insensitive.
A hub URL can be an HTTP(S) URL, a local file path, or an SSH URL — scp-style (git@host:org/repo.git) or scheme-style (ssh://git@host/org/repo.git). For SSH sources the index file is read from the repo via the //path suffix, defaulting to skillshare-hub.json at the repo root. SSH sources are cloned using your SSH agent/keys, which works for private and GitHub Enterprise hosts.
When an SSH hub contains same-host GitHub or GitHub Enterprise domain-prefixed entries, Skillshare installs them through the hub's SSH identity. For example, a hub added as acme@acme.ghe.com:Org/skills.git//hubs/team.json can contain acme.ghe.com/Org/skills/skills/reviewer, and search results install it as acme@acme.ghe.com:Org/skills.git//skills/reviewer. Outside an SSH hub, domain-prefixed sources still mean HTTPS.
skillshare hub add https://internal.corp/hub.json --label team
skillshare hub add ./local-hub.json # label derived: "local-hub"
skillshare hub add git@ghe.corp.com:team/skills.git --label ghe
skillshare hub add git@ghe.corp.com:team/skills.git//hubs/team.json --label ghe-team
hub list
List saved hubs. * marks the default hub.
skillshare hub list [options]
| Flag | Description |
|---|---|
--project, -p |
Show project hubs |
--global, -g |
Show global hubs |
$ skillshare hub list
team https://internal.corp/hub.json · default
local ./local-hub.json
2 hubs
Alias: hub ls
hub remove
Remove a saved hub by label.
skillshare hub remove <label> [options]
| Flag | Description |
|---|---|
--project, -p |
Remove from project config |
--global, -g |
Remove from global config |
If the removed hub was the default, the default is cleared.
Alias: hub rm
hub default
Show or set the default hub used by search --hub (bare flag).
skillshare hub default [label] [options]
| Flag | Description |
|---|---|
--reset |
Clear the default (revert to community hub) |
--project, -p |
Use project config |
--global, -g |
Use global config |
skillshare hub default # Show current default
skillshare hub default team # Set default to "team"
skillshare hub default --reset # Clear default → community hub
hub index
Build a skillshare-hub.json index file from installed skills. The generated index can be consumed by search --hub for private, offline skill discovery.
With follow_source_links: true in the active config, the index includes skills behind first-level source links, including with --source. The dashboard's built-in search and Hub draft candidates use the same discovery policy.
Usage
skillshare hub index [options]
Options
| Flag | Description |
|---|---|
--source, -s |
Source directory to scan (default: auto-detect) |
--output, -o |
Output file path (default: <source>/skillshare-hub.json) |
--full |
Include full metadata (flatName, type, version, etc.) |
--audit |
Run security audit on each skill and include risk scores |
--project, -p |
Use project mode (.skillshare/) |
--global, -g |
Use global mode (~/.config/skillshare) |
--help, -h |
Show help |
Output Modes
Minimal (default) — Only essential fields for search and install:
{
"schemaVersion": 1,
"generatedAt": "2026-02-12T10:00:00Z",
"sourcePath": "/home/user/.config/skillshare/skills",
"skills": [
{
"name": "my-skill",
"description": "A useful skill",
"source": "owner/repo/.claude/skills/my-skill",
"tags": ["workflow"]
}
]
}
Full (--full) — Includes metadata for auditing and management:
{
"name": "my-skill",
"description": "A useful skill",
"source": "github.com/owner/repo/.claude/skills/my-skill",
"tags": ["workflow"],
"flatName": "my-skill",
"type": "github-subdir",
"repoUrl": "https://github.com/owner/repo.git",
"version": "abc1234",
"installedAt": "2026-02-10T03:49:06Z",
"isInRepo": false
}
Audit (--audit) — Adds security risk scores from skillshare audit:
{
"name": "my-skill",
"description": "A useful skill",
"source": "owner/repo/.claude/skills/my-skill",
"riskScore": 0,
"riskLabel": "clean",
"auditedAt": "2026-02-22T10:00:00Z"
}
--audit can be combined with --full to include both metadata and risk scores. Risk labels: clean (0), low (1–25), medium (26–50), high (51–75), critical (76–100).
Metadata fields use omitempty — redundant values are suppressed:
flatNameomitted when equal tonamerelPathomitted when equal tosourceisInRepoomitted whenfalse
Examples
# Build minimal index (default)
skillshare hub index
# Build with full metadata
skillshare hub index --full
# Build with security risk scores
skillshare hub index --audit
# Full metadata + risk scores
skillshare hub index --full --audit
# Custom output path
skillshare hub index -o /shared/team/skillshare-hub.json
# Custom source directory
skillshare hub index -s ~/my-skills
# Project mode
skillshare hub index -p
Workflow
A typical private hub workflow:
1. Install skills → skillshare install ...
2. Build index → skillshare hub index
3. Share the index file → Commit/host skillshare-hub.json (HTTP, file, or Git repo)
4. Teammates search → skillshare search --hub [path-url-or-ssh]
When the index lives in a private or GitHub Enterprise repo, teammates can point --hub directly at it over SSH (git@host:org/repo.git) without each having to clone it locally first.
For more details, see the Hub Index Guide.
Config Format
Saved hubs are stored under the hub: key in config.yaml:
hub:
default: team
hubs:
- label: team
url: https://internal.corp/hub.json
- label: local
url: ./local-hub.json
- label: ghe
url: git@ghe.corp.com:team/skills.git//hubs/team.json
The public hub is the built-in default and doesn't need to be saved. When no custom default is set, search --hub falls back to it automatically. Fork this repo to bootstrap your own organization's hub.