CH·02CLI reference

gpu skill install

Install the skill into your coding agents' config

Synopsis

Writes the GPU.ai skill for the selected agents. With --agent auto (the default), installs for each agent whose config directory already exists (~/.claude, ~/.codex) so no unused directories are created; pass --agent explicitly to force one.

Per-agent behavior:

claude — writes a directory: ~/.claude/skills/gpu-ai/SKILL.md plus references/deploy.md, references/finetune.md, and references/troubleshooting.md beside it. Claude Code picks the skill up on its next start. Re-running install overwrites SKILL.md and replaces the whole managed references/ set, so a reference file that an older CLI shipped is removed rather than left behind as stale guidance; the gpu-ai/ directory itself and anything else you put there is left alone.
codex — maintains a managed block (between BEGIN gpu-ai skill / END gpu-ai skill markers) in ~/.codex/AGENTS.md. The block holds the skill body first, then reference content, and is kept under a size budget (24 KiB — headroom under Codex's own instruction-file limit, in a file you also write in), so the operating rules can never end up in a truncated tail. If the references would overrun the budget they are dropped from the end — troubleshooting first, then fine-tuning — and the body is always kept; with today's content the block carries the body plus deploy.md. Run gpu skill show --agent codex to see exactly what yours contains. Reinstalling replaces the block in place; anything you've written around it is left untouched. If one marker has been hand-deleted, the command errors instead of guessing.

Runs before gpu login — no authentication required.

gpu skill install [flags]

Examples

# Detect installed agents and install for each
gpu skill install

# Force a specific agent (creates its config dir if needed)
gpu skill install --agent codex

# Both, regardless of what's detected
gpu skill install --agent all

Options

      --agent string   Which agent to install for: claude | codex | all | auto (agents already on this machine) (default "auto")
  -h, --help           help for install

Synopsis

Examples

Options

SEE ALSO