SkillHub

config

Get or set configuration values in the project or global scope.

skillhub config reads and writes configuration in the project or global scope. With no key, it prints all effective entries and where each one came from.

The settable keys are:

  • registryUrl — the registry the CLI talks to. Already set to the hosted registry, so a fresh install needs no configuration.
  • agents — which coding agents skills fan out to.
  • copyMode — whether installs copy instead of link by default.
  • telemetry — whether anonymous usage telemetry is enabled.

Where registryUrl comes from

registryUrl is the one key that also answers to a flag and an environment variable. It resolves in order of precedence:

  1. The --registry-url flag on the command being run.
  2. The SKILLHUB_REGISTRY_URL environment variable — which points every command in a shell or CI job at one registry with nothing stored on disk.
  3. The registryUrl project config key.
  4. The registryUrl global config key.
  5. The built-in default: https://skillhub.fyi, the hosted registry.

The default is compiled into the binary rather than read from the environment, so the CLI reaches the hosted registry straight after npm i -g @uzolab/skillhub — with no config file, no environment variable, and no flag. Setting any of the four levels above only matters when you want a different registry; nothing has to be set for the default one to work.

skillhub whoami and config get both name which of those answered, so the effective URL is never a guess. On an untouched install that is default:

registry: https://skillhub.fyi (default)

Synopsis

skillhub config <get|set> [key] [value] [--global]

Flags

FlagDescription
--global, -gRead/write the machine-global scope instead of the project

Examples

skillhub config get
skillhub config get agents
skillhub config set copyMode true --global

JSON output

With --json, the data object is one of:

  • { action: "view", scope, entries[{ key, value, source }] } — no key given.
  • { action: "get", key, value, source } — a single get.
  • { action: "set", scope, key, value, path } — a set.

key is one of registryUrl, agents, copyMode, telemetry; source is one of flag, env, project, global, or default.

On this page