skillctl · examples

Using Skill Images

Skill images are standard OCI images. Mount them into containers and pods the same way you mount any other image — no special tooling required.

Mounting Methods

Three ways to mount a skill image, depending on your environment.

Linux (Podman / Docker)

Mount the skill image directly into a container using --mount type=image.

podman pull quay.io/myorg/my-skill:1.0.0

podman run --rm \
  --mount type=image,\
source=quay.io/myorg/my-skill:1.0.0,\
destination=/skills \
  my-agent:latest

Works with both Podman and Docker on Linux.

macOS (Podman / Docker)

The remote client doesn't support --mount type=image. Create an image-backed volume instead.

podman pull quay.io/myorg/my-skill:1.0.0

podman volume create --driver image \
  --opt image=quay.io/myorg/my-skill:1.0.0 \
  my-skill-vol

podman run --rm \
  -v my-skill-vol:/skills:ro \
  my-agent:latest

Kubernetes / OpenShift

Use ImageVolumes (beta in K8s 1.33, OpenShift 4.20+) to mount skills directly into pods.

# Pod spec (volumes + volumeMounts)
volumes:
  - name: skill
    image:
      reference: quay.io/myorg/my-skill:1.0.0
      pullPolicy: IfNotPresent
containers:
  - name: agent
    volumeMounts:
      - name: skill
        mountPath: /skills
        readOnly: true

Requires CRI-O runtime. Pulled and cached by the kubelet.

Demo: Skill in OpenCode

OpenCode is an open-source AI coding agent with a terminal UI. This walkthrough mounts a document-summarizer skill into OpenCode and uses it to summarize a blog post.

Step 1 — Pull and create a volume

Pull the skill image and create an image-backed volume (works on both Linux and macOS).

podman pull quay.io/skillimage/business/document-summarizer:1.0.0-testing

podman volume create --driver image \
  --opt image=quay.io/skillimage/business/document-summarizer:1.0.0-testing \
  summarizer-skill
Step 2 — Start OpenCode with the skill mounted

Mount the volume into OpenCode's skill directory. OpenCode discovers skills automatically.

podman run -it --rm \
  -v summarizer-skill:/root/.config/opencode/skills/document-summarizer \
  ghcr.io/anomalyco/opencode
Step 3 — Use the skill

Inside the OpenCode TUI, run /skills to confirm the document-summarizer is loaded. Then ask the agent to summarize a document — it will use web fetch to retrieve the content and apply the skill automatically.

> /skills
document-summarizer  loaded

> please summarize this blog:
  https://next.redhat.com/2026/03/05/zero-trust-ai-agents/
Using tool: web_fetch ...
Using skill: document-summarizer ...
## Summary
The article discusses deploying multi-agent systems
on Kubernetes with zero-trust networking ...