AgentKit
ReferenceCLI commands
BetaYou are reading docs for the beta channel (2.4.1-beta.1) — updated automatically on every beta release.Switch to stable →

CLI commands

ak skill install

Install or refresh the per-skill runtime env

Install or refresh the per-skill runtime env. Idempotent—safe to re-run.

When to use it: After cloning the repo or after editing skill.yaml's runtime block. Use ak skill upgrade instead when only the constraint string changed.

Writes to ~/.agentkit/skills/<kit>/<skill>/.manifest.json and ~/.agentkit/cache/<runtime-hash>/.

Usage

ak skill install <kit>/<skill> [flags]

Examples

ak skill install marketing/youtube
ak skill install engineer/web-testing --kits-dir kits/

Global flags, output modes, and the standard exit codes (03) are shared by every command — see CLI conventions. The sections below list only what is specific to this command.

Flags

FlagDescription
--kits-dir stringKits directory (default: ./kits or $AGENTKIT_KITS_DIR)

Exit codes

CodeMeaning
4missing tool (uv / pnpm) or skill has no runtime block
5kit or skill not found
  • ak skill — Manage per-skill runtime envs

On this page