Apko

Use this skill when the user wants to build a minimal OCI container image declaratively from APK packages, or inspect/lock an apko.yaml config.

57 stars 5 forksImages, Video & Audio

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add javimosch/supercli --skill apko
Manual install
git clone --depth 1 https://github.com/javimosch/supercli.git /tmp/supercli
mkdir -p ~/.claude/skills
cp -r /tmp/supercli/plugins/apko/skills/quickstart ~/.claude/skills/apko

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# apko Plugin

apko builds OCI images from a YAML manifest listing APK packages — no Dockerfile, no base image required. Produces reproducible multi-arch images with automatic SBOMs; works with Alpine, Wolfi, and Chainguard repositories.

## Commands

### Build
- `apko image build` — `apko build <config.yaml> <tag> <output.tar>` (then `docker load`)
- `apko image publish` — Build and push straight to a registry

### Config
- `apko config show` — Parse and print the resolved config
- `apko lock generate` — Write apko.lock.json pinning exact packages

### Other
- `apko _ _` — Passthrough (`apko show-packages`, `apko resolve`, `apko build-minirootfs`)

## Usage Examples

- "Build an OCI image from this apko.yaml into image.tar"
- "Show the resolved apko config for debugging"
- "Generate a lockfile so builds are bit-for-bit reproducible"

## Installation

```bash
go install chainguard.dev/apko@latest
# or: brew install apko
# or: mise use -g apko@latest
```

## Examples

```bash
apko build examples/alpine-base.yaml apko-example:latest output.tar
docker load < output.tar
apko build apko.yaml ghcr.io/org/app:v1 out.tar && apko publish apko.yaml ghcr.io/org/app:v1
apko show-config apko.yaml
apko lock apko.yaml --output apko.lock.json
```

## Key Features

- Single YAML declares contents, entrypoint, users, env, archs
- `--build-arch`/`--arch` for multi-arch manifests
- Built-in SBOMs (SPDX + CycloneDX) per arch
- Lockfile + `--locked` for reproducible rebuilds
Read the full skill on GitHub

Details

Skill name
apko
Path
plugins/apko/skills/quickstart/SKILL.md
License
MIT
Repo updated
2 November 2026

FAQ

What does the Apko skill do?

Use this skill when the user wants to build a minimal OCI container image declaratively from APK packages, or inspect/lock an apko.yaml config.

How do I install the Apko skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add javimosch/supercli --skill apko. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Apko popular?

It lives in javimosch/supercli, which has 57 GitHub stars and 5 forks, and is included in 1 curated skill list.

Related skills

Browse the most popular Claude skills, all images, video & audio skills, or write your own with the skills generator.