Files
skillshare/website/docs/reference/commands/hub.md
T
2026-06-05 13:56:07 +08:00

6.8 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
    local  ./local-hub.json

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.

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.