Agentic Data Plane

rpk ai skill init

Install a session-start hook in each coding agent on this machine, so the skills your manifests name are synced whenever a session starts and you never run sync by hand. Run it once. Running it again changes nothing, unless the CLI has moved, in which case it updates each hook to the CLI’s new path.

Coding agent What init adds

Claude Code

a SessionStart hook in $CLAUDE_CONFIG_DIR/settings.json, else ~/.claude/settings.json

Codex

a SessionStart hook in $CODEX_HOME/hooks.json, else ~/.codex/hooks.json. Codex skips it until you trust it with /hooks

OpenCode

a plugin, ~/.config/opencode/plugins/rpk-ai-skill-sync.js, that runs sync when OpenCode 2 starts. OpenCode documents no way for a plugin to show a line, so the report goes to its log

init skips a coding agent that is not installed (its command is not on PATH and its config folder does not exist) and says so; run init again after you install it. It adds its own hook and changes nothing else in those files.

The hook runs sync with a 5-second limit. When sync runs out of time, cannot reach the registry or finds your sign-in expired, the skills the last sync installed stay in place and the session starts as usual. Claude Code and Codex show one line saying why; OpenCode writes it to its log.

init also prints a requirements.toml fragment that runs the same hook for every Codex user in your organization, for an admin to push as a managed hook. Codex trusts a managed hook without the /hooks step.

Usage

rpk ai skill init [flags]

Examples

This section provides examples of how to use rpk ai skill init.

rpk ai skill init
rpk ai skill init

Global flags

Value Type Description

--config

string

Redpanda or rpk config file; default search paths are ~/.config/rpk/rpk.yaml, $PWD/redpanda.yaml, and /etc/redpanda/redpanda.yaml.

-X, --config-opt

stringArray

Override rpk configuration settings; -X help for detail or -X list for terser detail.

--ignore-profile

bool

Ignore rpk.yaml and redpanda.yaml; use default settings.

--profile

string

rpk profile to use.

-v, --verbose

bool

Enable verbose logging.