oap skill

Manage agent skills.

A SkillSource pulls SKILL.md files from a git repo and materializes Skills. Skills can also be hand-authored from a local SKILL.md directory (instruction-only). Use --cluster on any subcommand to target the cluster-scoped ClusterSkill/ClusterSkillSource.

oap skill create --from-dir <dir>

Reads <dir>/SKILL.md, validates its frontmatter, and creates an instruction-only Skill with a reserved local:// canonical name (local/<namespace>//<name>, or local//<name> with --cluster).

For executable skills (scripts/assets) or git-sourced skills, use a SkillSource instead (oap skill source create); scripts/ and assets/ in the directory are NOT bundled here.

Flags:

--cluster          Create a cluster-scoped ClusterSkill
--from-dir string  Directory containing the SKILL.md to author from

oap skill delete <name>

<name> is the Kubernetes object name (as shown in oap skill list).

Note: a Skill materialized by a SkillSource is recreated on the next sync; delete the SkillSource (oap skill source delete) to stop materializing it.

Flags:

--cluster  Delete a cluster-scoped ClusterSkill

oap skill list

List Skills (or ClusterSkills with --cluster)

Flags:

--cluster  List cluster-scoped ClusterSkills instead of namespaced Skills

oap skill show <name>

<name> is the Kubernetes object name (as shown in oap skill list), not the canonical name.

Flags:

--cluster  Target a cluster-scoped ClusterSkill

oap skill source

Aliases: sources, src.

List, view, create, and delete SkillSources (git repos that yield Skills)

oap skill source create <name> --repo <url>

Creates a SkillSource that clones <url> and materializes Skills from SKILL.md files under --subpath. For a private repo, supply auth: namespaced: --identity <AgentIdentity> --credential <name> cluster: --secret-namespace <ns> --secret-name <name> --secret-key <key>

Flags:

--cluster                  Create a cluster-scoped ClusterSkillSource
--credential string        AgentCredential name on the AgentIdentity (namespaced)
--identity string          AgentIdentity holding the clone credential (namespaced)
--ref string               Branch, tag, or commit SHA to fetch (default: the repo's default branch)
--repo string              Git repo URL to clone (required)
--secret-key string        Key in the clone-token Secret (--cluster) (default "token")
--secret-name string       Name of the clone-token Secret (--cluster)
--secret-namespace string  Namespace of the clone-token Secret (--cluster)
--subpath string           Restrict SKILL.md discovery to this subtree (e.g. .claude/skills)

oap skill source delete <name>

Deleting a source garbage-collects the Skills it materialized (owner references).

Flags:

--cluster  Delete a cluster-scoped ClusterSkillSource

oap skill source list

List SkillSources (or ClusterSkillSources with --cluster)

Flags:

--cluster  List cluster-scoped ClusterSkillSources

oap skill source show <name>

Show a SkillSource's spec, resolved SHA, discovery problems, and status

Flags:

--cluster  Target a cluster-scoped ClusterSkillSource