Files
skillshare/website/docs/reference/commands/hub.md
T
Willie 113d410da7 fix(hub): apply the source follow policy to local discovery
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.
2026-10-05 22:03:47 +08:00

7.0 KiB
Raw Blame History

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 search to 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:

  • flatName omitted when equal to name
  • relPath omitted when equal to source
  • isInRepo omitted when false

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.