Registry

The registry is an optional JSON API that provides a curated skill index. When enabled, query and find commands will also query the registry alongside configured sources.

FieldRequiredDefaultDescription
registry.enabledNofalseEnable registry lookup
registry.urlNohttps://xskill.gcli.cn/skills.jsonRegistry URL

URL resolution rules:

  • Bare domain or trailing / → auto-append /skills.json
  • Path ending with a file extension (e.g. .json) → use as-is
  • Empty or invalid protocol → fall back to built-in default

Deduplication (URL-normalized, local takes priority):

  • If a registry source has the same URL as a configured source → skipped (local config wins).
  • If a registry source has the same name but a different URL → kept as a separate source; registry entry’s source name is blanked (shown as - in query, or the source URL in find).
  • No conflict → displayed normally.
  • Skill-level dedup: only skipped when URLs match. Different URLs with same skill name are kept as separate entries.

Examples:

# Enable registry
xskill config --set registry.enabled=true

# Use a custom registry URL (bare domain)
xskill config --set registry.url=https://example.com

# Use a custom registry URL (with path)
xskill config --set registry.url=https://example.com/api/v1/