Command reference
Captured from skillgate --help on skillgate-ai 0.7.9. Regenerate with scripts/capture_cli_help_snapshot.py after CLI changes.
Platform notes
skillgate connect,skillgate helper --install-launchd, andskillgate sync --install-launchdare macOS-only (LaunchAgent helpers).skillgate synccopies skills from a Git repo into agent folders without requiring a passing check;deploydoes require a green check.skillgate loginandskillgate login --statussign in Cursor, Claude Code, or Codex for live checks.
skillgate
Usage: skillgate [OPTIONS] COMMAND [ARGS]...
Skill Gate — evaluate agent skills. Pack on disk + `skillgate check` (exit
0/1).
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --version Print the CLI version. │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ version Print the CLI version. │
│ login Sign in with an agent using that agent's official login. │
│ doctor Show whether agents are installed and signed in. │
│ ingest Validate a skill folder against the agentskills spec. │
│ check Exit 0 if green, 1 if red, 2 if it cannot run. Runs pack-local │
│ evals/cases.yaml. │
│ run Run an eval pack or suite YAML. Prefer `skillgate check` for CI. │
│ deploy Copy a skill pack into a local agent skills directory. │
│ sync Pull a skills repo and copy its skills into local agent dirs. │
│ connect Pair this Mac with a hosted Skill Gate (stores a token at 0600). │
│ helper Poll a hosted Skill Gate for deploy jobs and install skills │
│ (outbound only). │
│ list Show skills/ and evals/ (skill-first paths). │
│ init Create a Skill Gate workspace (`skills/` and ignore │
│ `.skillgate/`). │
│ new Create `skills/NAME` with SKILL.md and starter checks (same as the │
│ UI). │
│ example Copy a packaged example skill into this folder. │
│ ui Local React UI. No account. Run needs an agent (`skillgate login` │
│ or a key). │
│ import Copy skills from a folder, git URL, agent folder, zip, or │
│ SKILL.md. │
│ keys Set keys in this project. Never reads OPENAI_API_KEY from the │
│ shell unless --key-env. │
│ examples List and install example skills that ship with a dataset. │
│ judge Show extra scoring questions and pick who scores live checks. │
│ checks Show the judge prompt for a built-in or custom check. │
│ case Add checks to evals/cases.yaml. │
│ skill Edit files in a skill pack (SKILL.md, fixtures, cases.yaml). │
│ history Show recent check runs for this skill. │
│ compare Side-by-side compare on one Dataset (models or versions). │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate version
Usage: skillgate version [OPTIONS]
Print the CLI version.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate login
Usage: skillgate login [OPTIONS] [agent]
Sign in with an agent using that agent's official login.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ agent <str> cursor | claude | codex. Omit to sign in missing agents. │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --status Show installed / logged in / API key / none. │
│ --json Machine JSON │
│ --force Run the official login even if already signed in. │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate doctor
Usage: skillgate doctor [OPTIONS]
Show whether agents are installed and signed in.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --json Machine JSON │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate init
Usage: skillgate init [OPTIONS] [dest]
Create a Skill Gate workspace (`skills/` and ignore `.skillgate/`).
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ dest <path> Workspace folder (default: current directory) │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate new
Usage: skillgate new [OPTIONS] {name}
Create `skills/NAME` with SKILL.md and starter checks (same as the UI).
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * name <str> Skill folder name (lowercase, hyphens) [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate example
Usage: skillgate example [OPTIONS] {name}
Copy a packaged example skill into this folder.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * name <str> pdf | pdf-sabotaged [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --dest <path> Folder to write (default: skills/NAME) │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate examples
Usage: skillgate examples [OPTIONS] COMMAND [ARGS]...
List and install example skills that ship with a dataset.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ list List example skills you can install. │
│ install Copy example skills into the skills folder. Existing files stay as │
│ they are. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate examples list
Usage: skillgate examples list [OPTIONS]
List example skills you can install.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate examples install
Usage: skillgate examples install [OPTIONS] [name]
Copy example skills into the skills folder. Existing files stay as they are.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ name <str> One example. Omit to install every dataset example. │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --dest <path> Skills folder (default: ./skills) │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate import
Usage: skillgate import [OPTIONS] [target]
Copy skills from a folder, git URL, agent folder, zip, or SKILL.md.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ target <str> Local skill folder or git URL (https://… or git@…) │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --source <str> cursor | claude | codex (repeatable) │
│ --zip <path> Zip of a skill folder │
│ --md <path> A SKILL.md file │
│ --only <str> Import only these skill slugs (repeatable) │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate ingest
Usage: skillgate ingest [OPTIONS] {skill}
Validate a skill folder against the agentskills spec.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * skill <path> Path to a skill folder containing SKILL.md │
│ [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate check
Usage: skillgate check [OPTIONS] {pack}
Exit 0 if green, 1 if red, 2 if it cannot run. Runs pack-local
evals/cases.yaml.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * pack <path> Skill pack directory (SKILL.md + evals/) [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --harness <str> auto | cursor | cursor-agent | codex | │
│ claude │
│ --sandbox <str> local (default) [default: local] │
│ --expect-fail Exit 0 only if the suite is red │
│ (sabotaged / intentional-fail) │
│ --summary <str> cli | github | json [default: cli] │
│ --json Machine JSON (not the primary UX) │
│ --model <str> Requested model id │
│ --timeout <int> Per-task timeout seconds │
│ --temperature <float> Temperature (0–2) │
│ --reasoning-effort <str> Reasoning effort: low | medium | high | │
│ ultra │
│ --key-env <str> Use this process env name as a Skill Gate │
│ key (repeatable). CI: set │
│ SKILLGATE_OPENAI_API_KEY, or pass │
│ --key-env OPENAI_API_KEY. │
│ --case <str> Run this check only (try-out) │
│ --no-judge Allow a run without a scoring key (exit 0 │
│ even when quality is not scored). │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate run
Usage: skillgate run [OPTIONS] {suite}
Run an eval pack or suite YAML. Prefer `skillgate check` for CI.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * suite <path> Skill pack directory or eval suite YAML [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --skill <path> Override the skill folder │
│ --harness <str> auto | cursor | cursor-agent | codex | │
│ claude │
│ --sandbox <str> local (default) [default: local] │
│ --expect-fail Exit 0 only if the suite is red │
│ (sabotaged / intentional-fail) │
│ --summary <str> cli | github | json [default: cli] │
│ --json Machine JSON (not the primary UX) │
│ --model <str> Requested model id │
│ --timeout <int> Per-task timeout seconds │
│ --temperature <float> Temperature (0–2) │
│ --reasoning-effort <str> Reasoning effort: low | medium | high | │
│ ultra │
│ --key-env <str> Use this process env name as a Skill Gate │
│ key (repeatable). CI: set │
│ SKILLGATE_OPENAI_API_KEY, or pass │
│ --key-env OPENAI_API_KEY. │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate deploy
Usage: skillgate deploy [OPTIONS] {pack}
Copy a skill pack into a local agent skills directory.
Refuses unless this pack already has a passing check and an agent is
available (API key or `skillgate login`). Does not run check. Copies skill
files only (not evals/). --force only overrides a red latest check; it does
not skip a missing agent.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * pack <path> Gated skill pack to copy [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --target <str> cursor | claude | codex (comma ok) │
│ --targets <str> Same as --target; one name or a comma list │
│ --force Install even if the latest check did not pass. Does │
│ not skip a skill that has never been checked. │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate sync
Usage: skillgate sync [OPTIONS]
Pull a skills repo and copy its skills into local agent dirs.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ * --repo <str> Git repo URL with skills/ inside │
│ [required] │
│ --target <str> Same as --targets │
│ --targets <str> Comma-separated targets (default │
│ cursor,codex,claude) │
│ --interval <int> Seconds between syncs (0 = once) │
│ [default: 0] │
│ --install-launchd Install a macOS LaunchAgent for sync │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate keys
Usage: skillgate keys [OPTIONS] COMMAND [ARGS]...
Set keys in this project. Never reads OPENAI_API_KEY from the shell unless
--key-env.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ set Write a key into `.skillgate/keys` (mode 0600). │
│ clear Remove a key from `.skillgate/keys`. │
│ list Show which keys are set. Never prints values. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate keys set
Usage: skillgate keys set [OPTIONS] {name} [value]
Write a key into `.skillgate/keys` (mode 0600).
Names include CURSOR_API_KEY, CODEX_API_KEY, OPENAI_API_KEY, JEV_API_KEY,
CLOUDFLARE_API_TOKEN, CUSTOM_DECISION_API_KEY, and AI Gateway key
(AI_GATEWAY_API_KEY).
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * name <str> CURSOR_API_KEY | CODEX_API_KEY | OPENAI_API_KEY | │
│ JEV_API_KEY | CLOUDFLARE_API_TOKEN | │
│ CUSTOM_DECISION_API_KEY | AI Gateway key | … │
│ [required] │
│ value <str> The secret. Omit to paste hidden (TTY) or read stdin. │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate keys list
Usage: skillgate keys list [OPTIONS]
Show which keys are set. Never prints values.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate keys clear
Usage: skillgate keys clear [OPTIONS] {name}
Remove a key from `.skillgate/keys`.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * name <str> Key name to remove [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate judge
Usage: skillgate judge [OPTIONS] COMMAND [ARGS]...
Show extra scoring questions and pick who scores live checks.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ show Print built-in questions, then extras. │
│ reset Drop extras and Fail vs warn overrides. Built-ins stay. │
│ add-question Add an extra scoring question to this skill. │
│ test Test the scoring connection. Never prints the key. │
│ remove-question Remove an extra scoring question. Skill Gate’s six stay. │
│ set-question Change Fail vs warn for a built-in or extra question. │
│ provider Who scores live checks. A decision model is required. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate judge test
Usage: skillgate judge test [OPTIONS]
Test the scoring connection. Never prints the key.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --key-env <str> Use this process env name as a Skill Gate key │
│ (repeatable). CI: set SKILLGATE_OPENAI_API_KEY, or │
│ pass --key-env OPENAI_API_KEY. │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate judge provider set
Usage: skillgate judge provider set [OPTIONS] {provider}
Write `.skillgate/judge`. Stores env var names, never key values.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * provider <str> A decision-model endpoint id, or auto to clear the │
│ selection │
│ [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --base-url <str> │
│ --region <str> │
│ --model <str> │
│ --account-id <str> Account id for this decision model │
│ --key-env <str> Use this process env name as a Skill Gate key │
│ (repeatable). CI: set SKILLGATE_OPENAI_API_KEY, │
│ or pass --key-env OPENAI_API_KEY. │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate judge provider show
Usage: skillgate judge provider show [OPTIONS]
Who scores live checks.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate judge provider test
Usage: skillgate judge provider test [OPTIONS]
Test the scoring connection. Never prints the key.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --key-env <str> Use this process env name as a Skill Gate key │
│ (repeatable). CI: set SKILLGATE_OPENAI_API_KEY, or │
│ pass --key-env OPENAI_API_KEY. │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate judge add-question
Usage: skillgate judge add-question [OPTIONS] [pack]
Add an extra scoring question to this skill.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ pack <path> Skill pack │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ * --ask <str> Question text [required] │
│ --type <str> Yes/No | pick one | score [default: Yes/No] │
│ --id <str> Optional question id │
│ --warn-only Warn instead of failing the check │
│ --choices <str> Pick-one options (repeatable) │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate case
Usage: skillgate case [OPTIONS] COMMAND [ARGS]...
Add checks to evals/cases.yaml.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ add Add a check to this skill's Dataset. │
│ list List saved checks. │
│ remove Remove a custom check. Original seed checks stay. │
│ edit Edit a saved check. │
│ import Import checks from a dataset file into evals/cases.yaml. │
│ bind Attach this skill’s sample files to checks that need them. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate case add
Usage: skillgate case add [OPTIONS] [pack]
Add a check to this skill's Dataset.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ pack <path> Skill pack │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ * --prompt <str> What the agent should do [required] │
│ --id <str> Optional check id │
│ --expected <str> Expected text in the output │
│ --output <str> Output file to compare │
│ --input,--fixture <path> Input/fixture file to copy into this │
│ skill │
│ --no-trigger This check should not run the skill │
│ --force Replace a check that already uses this │
│ id │
│ --output-optional Accept a missing or empty output file. │
│ Expected stays reference text. │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate case edit
Usage: skillgate case edit [OPTIONS] [pack]
Edit a saved check.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ pack <path> Skill pack │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ * --id <str> Check id [required] │
│ --prompt <str> │
│ --expected <str> │
│ --output <str> │
│ --output-optional <str> true accepts a missing or empty output │
│ file and keeps Expected as reference text │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate case remove
Usage: skillgate case remove [OPTIONS] [pack]
Remove a custom check. Original seed checks stay.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ pack <path> Skill pack │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ * --id <str> Check id to remove [required] │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate case list
Usage: skillgate case list [OPTIONS] [pack]
List saved checks.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ pack <path> Skill pack │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate case import
Usage: skillgate case import [OPTIONS] [pack] {file}
Import checks from a dataset file into evals/cases.yaml.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ pack <path> Skill pack │
│ * file <path> CSV, JSONL, or YAML file [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --dry-run Preview without writing │
│ --on-conflict <str> When a check id already exists: fail, skip, or │
│ replace │
│ [default: fail] │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate skill
Usage: skillgate skill [OPTIONS] COMMAND [ARGS]...
Edit files in a skill pack (SKILL.md, fixtures, cases.yaml).
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ write Write a file in this skill (SKILL.md, fixtures, evals/cases.yaml). │
│ paste Create a skill from a pasted SKILL.md (same as the UI paste). │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate history
Usage: skillgate history [OPTIONS] COMMAND [ARGS]...
Show recent check runs for this skill.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --pack <path> Skill pack │
│ --json │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ show Show one saved run. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate history show
Usage: skillgate history show [OPTIONS] {run_id}
Show one saved run.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * run_id <str> Run id [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --pack <path> Skill pack │
│ --json │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate compare
Usage: skillgate compare [OPTIONS] COMMAND [ARGS]...
Side-by-side compare on one Dataset (models or versions).
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ models Run the same Dataset on multiple harness setups. │
│ versions Compare two skill versions on the same Dataset. │
│ show Show a compare job. │
│ cancel Cancel an in-flight compare (same as the Compare tab Cancel │
│ button). │
│ list List recent compare jobs for a pack. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate compare models
Usage: skillgate compare models [OPTIONS] {pack}
Run the same Dataset on multiple harness setups.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * pack <path> Skill pack directory [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --arm <str> Label:harness[:model] (repeatable) │
│ --arm-file <path> JSON arm config (repeatable) │
│ --max-spend-usd <float> Stop before next arm [default: 5.0] │
│ --cases <str> Comma-separated case ids │
│ --dry-run Print plan only │
│ --json Machine JSON (scrubbed) │
│ --key-env <str> Use this process env name as a Skill Gate │
│ key (repeatable). CI: set │
│ SKILLGATE_OPENAI_API_KEY, or pass --key-env │
│ OPENAI_API_KEY. │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate compare versions
Usage: skillgate compare versions [OPTIONS] {pack}
Compare two skill versions on the same Dataset.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * pack <path> Skill pack directory [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --run <str> History run id (repeat twice) │
│ --git <str> Git ref (repeat twice) │
│ --harness <str> Harness for --git arms. Defaults to the harness of │
│ this skill's history runs. │
│ --rerun Re-run both arms using stored configs │
│ --dry-run Print plan only │
│ --json Machine JSON (scrubbed) │
│ --key-env <str> Use this process env name as a Skill Gate key │
│ (repeatable). CI: set SKILLGATE_OPENAI_API_KEY, or │
│ pass --key-env OPENAI_API_KEY. │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate compare show
Usage: skillgate compare show [OPTIONS] {compare_id}
Show a compare job.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * compare_id <str> Compare id [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --skill <path> Skill pack (optional) │
│ --json Machine JSON (scrubbed) │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate compare list
Usage: skillgate compare list [OPTIONS] [pack]
List recent compare jobs for a pack.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ pack <path> Skill pack directory │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --skill <path> Skill pack (same as positional) │
│ --json Machine JSON (scrubbed) │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate compare cancel
Usage: skillgate compare cancel [OPTIONS] {compare_id}
Cancel an in-flight compare (same as the Compare tab Cancel button).
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * compare_id <str> Compare id to stop [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate list
Usage: skillgate list [OPTIONS]
Show skills/ and evals/ (skill-first paths).
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate ui
Usage: skillgate ui [OPTIONS]
Local React UI. No account. Run needs an agent (`skillgate login` or a key).
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --host <str> Bind address (default loopback) │
│ [default: 127.0.0.1] │
│ --port <int> Port (default 8765) [default: 8765] │
│ --root <path> Workspace root for browse/create │
│ --pack <path> Open this pack instead of the picker │
│ --open Open the loopback URL in a browser │
│ --no-browser Do not open a browser │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate connect
Usage: skillgate connect [OPTIONS]
Pair this Mac with a hosted Skill Gate (stores a token at 0600).
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ * --url <str> Hosted Skill Gate URL [required] │
│ * --code <str> One-time pairing code [required] │
│ --name <str> Nickname for this Mac │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
skillgate helper
Usage: skillgate helper [OPTIONS]
Poll a hosted Skill Gate for deploy jobs and install skills (outbound only).
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --once Poll once and exit │
│ --install-launchd Install a macOS LaunchAgent for the helper │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯