hub

skill hub를 관리합니다 — 조직 전체의 skill 검색을 위해 저장된 hub 소스입니다.

사용 시점

• search가 조회할 조직의 skill 카탈로그 설정
• 여러 hub 간 전환 (예: 회사 전체 vs 팀별)
• 저장된 hub 소스 목록 확인 또는 제거

hub add

hub 소스를 config에 저장하여 search --hub에서 재사용합니다.

skillshare hub add <url> [options]

Flag	설명
--label, -l	사용자 지정 label (기본값: URL 호스트명에서 도출)
--project, -p	프로젝트 config에 저장
--global, -g	전역 config에 저장

처음 추가된 hub는 자동으로 기본값으로 설정됩니다. Label은 대소문자를 구분하지 않습니다.

hub URL은 HTTP(S) URL, 로컬 파일 경로, 또는 SSH URL(scp 스타일 git@host:org/repo.git 또는 scheme 스타일 ssh://git@host/org/repo.git)이 될 수 있습니다. SSH 소스의 경우 index 파일은 //path 접미사를 통해 저장소에서 읽어오며, 기본값은 저장소 루트의 skillshare-hub.json입니다. SSH 소스는 사용자의 SSH agent/키를 사용하여 클론되므로 비공개 저장소와 GitHub Enterprise 호스트에서도 작동합니다.

SSH hub에 동일 호스트의 GitHub 또는 GitHub Enterprise 도메인 접두사 항목이 포함된 경우, Skillshare는 해당 hub의 SSH identity를 통해 설치합니다. 예를 들어 acme@acme.ghe.com:Org/skills.git//hubs/team.json으로 추가된 hub에 acme.ghe.com/Org/skills/skills/reviewer가 포함될 수 있으며, 검색 결과는 이를 acme@acme.ghe.com:Org/skills.git//skills/reviewer로 설치합니다. SSH hub 외부에서는 도메인 접두사 소스가 여전히 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

저장된 hub 목록을 표시합니다. *는 기본 hub를 표시합니다.

skillshare hub list [options]

Flag	설명
--project, -p	프로젝트 hub 표시
--global, -g	전역 hub 표시

$ skillshare hub list
  team      https://internal.corp/hub.json · default
  local     ./local-hub.json

2 hubs

별칭: hub ls

hub remove

label로 저장된 hub를 제거합니다.

skillshare hub remove <label> [options]

Flag	설명
--project, -p	프로젝트 config에서 제거
--global, -g	전역 config에서 제거

제거된 hub가 기본값이었다면 기본값이 초기화됩니다.

별칭: hub rm

hub default

search --hub(플래그 단독 사용 시)가 사용하는 기본 hub를 표시하거나 설정합니다.

skillshare hub default [label] [options]

Flag	설명
--reset	기본값 초기화 (community hub로 되돌림)
--project, -p	프로젝트 config 사용
--global, -g	전역 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

설치된 skill로부터 skillshare-hub.json index 파일을 빌드합니다. 생성된 index는 비공개 오프라인 skill 검색을 위해 search --hub에서 사용할 수 있습니다.

활성 설정에서 follow_source_links: true를 지정하면 --source를 사용할 때도 첫 번째 수준 source 링크 뒤의 skill이 인덱스에 포함됩니다. 대시보드의 기본 검색과 Hub 초안 후보도 같은 발견 정책을 사용합니다.

Usage

skillshare hub index [options]

Options

Flag	설명
--source, -s	스캔할 소스 디렉터리 (기본값: 자동 감지)
--output, -o	출력 파일 경로 (기본값: <source>/skillshare-hub.json)
--full	전체 메타데이터 포함 (flatName, type, version 등)
--audit	각 skill에 대해 보안 audit을 실행하고 위험 점수 포함
--project, -p	프로젝트 모드 사용 (.skillshare/)
--global, -g	전역 모드 사용 (~/.config/skillshare)
--help, -h	도움말 표시

Output Modes

Minimal (기본값) — 검색 및 설치에 필요한 필수 필드만 포함:

{
  "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) — audit 및 관리를 위한 메타데이터 포함:

{
  "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) — 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은 --full과 함께 사용하여 메타데이터와 위험 점수를 모두 포함할 수 있습니다. 위험 label: clean (0), low (1–25), medium (26–50), high (51–75), critical (76–100).

메타데이터 필드는 omitempty를 사용합니다 — 중복되는 값은 생략됩니다:

• flatName은 name과 같으면 생략
• relPath는 source와 같으면 생략
• isInRepo는 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

일반적인 비공개 hub 워크플로우:

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]

index가 비공개 또는 GitHub Enterprise 저장소에 있는 경우, 팀원들은 각자 로컬로 클론할 필요 없이 SSH를 통해 --hub를 직접 지정할 수 있습니다 (git@host:org/repo.git).

자세한 내용은 Hub Index Guide를 참고하세요.

Config Format

저장된 hub는 config.yaml의 hub: 키 아래에 저장됩니다:

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

public hub는 내장된 기본값이며 별도로 저장할 필요가 없습니다. 사용자 지정 기본값이 설정되지 않은 경우, search --hub는 자동으로 여기로 폴백됩니다. 이 저장소를 fork하여 자체 조직의 hub를 구축하세요.