Agent skill

Kappal

Deploy docker-compose projects to Kubernetes using Kappal. An agent skill from sandys/kappal.

No licenceAuto-check passedDevOps & Cloud

Install Kappal

skills CLI

$ npx skills add sandys/kappal --skill kappal -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install sandys/kappal kappal --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/sandys/kappal.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/kappal .claude/skills/kappal && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "kappal" agent skill from https://github.com/sandys/kappal/tree/main/skills/kappal into .claude/skills/kappal/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "kappal", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/sandys/kappal/tree/main/skills/kappal

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add sandys/kappal --skill kappal -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install sandys/kappal kappal --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/sandys/kappal.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/kappal .agents/skills/kappal && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "kappal" agent skill from https://github.com/sandys/kappal/tree/main/skills/kappal into .agents/skills/kappal/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "kappal", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add sandys/kappal --skill kappal -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install sandys/kappal kappal --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/sandys/kappal.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/kappal .cursor/skills/kappal && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "kappal" agent skill from https://github.com/sandys/kappal/tree/main/skills/kappal into .cursor/skills/kappal/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "kappal", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/sandys/kappal.git --path skills/kappal

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add sandys/kappal --skill kappal -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install sandys/kappal kappal --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/sandys/kappal.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/kappal .gemini/skills/kappal && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "kappal" agent skill from https://github.com/sandys/kappal/tree/main/skills/kappal into .gemini/skills/kappal/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "kappal", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install sandys/kappal kappal

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add sandys/kappal --skill kappal -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/sandys/kappal.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/kappal .github/skills/kappal && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "kappal" agent skill from https://github.com/sandys/kappal/tree/main/skills/kappal into .github/skills/kappal/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "kappal", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add sandys/kappal --skill kappal -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install sandys/kappal kappal --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/sandys/kappal.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/kappal .opencode/skills/kappal && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "kappal" agent skill from https://github.com/sandys/kappal/tree/main/skills/kappal into .opencode/skills/kappal/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "kappal", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: kappal
GitHub stars: 115
Token cost: ~4.9k tokens
SKILL.md length: 2,145 words
Files: 1
Skills in repo: 1
Repo updated: Feb 15, 2026
First seen: Oct 7, 2026
Licence: None found

At a glance

Deploy docker-compose projects to Kubernetes using Kappal. An agent skill from sandys/kappal.

Works in 10 steps: Self-Update → Overview → How to Invoke Kappal → …
The user wants to run docker-compose on Kubernetes
SKILL.md covers 0. Self-Update, 1. Overview, 2. How to Invoke Kappal and 3. Scenario Templates, plus 4 more sections
Calls docker, jq and curl

What it does

Kappal is an agent skill from sandys/kappal. Deploy docker-compose projects to Kubernetes using Kappal. Use when the user wants to run docker-compose on Kubernetes, deploy with kappal, or says "make this run in kappal". Handles setup, build, deploy, logs, and teardown autonomously.

Its SKILL.md is about 4.9k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud, covering Containers and Container orchestration. It works with Docker and Kubernetes.

When your agent uses it

The user wants to run docker-compose on Kubernetes
Deploy with kappal
Says make this run in kappal

Example prompts

“make this run in kappal”
“/kappal”

Requirements

Docker

Workflow steps

10 steps, taken from the step headings in SKILL.md.

Self-Update
Overview
How to Invoke Kappal
Scenario Templates
Autonomous Workflow
Command Reference
Compose Feature Support
Build Args vs Runtime Environment (Critical)
Project Naming
Common Pitfalls

What it can do on your machine

Read from SKILL.md and the folder at commit 8463cef. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- docker
- jq
- curl
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use docker and curl, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Kappal loads about 4.9k tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 2,145 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~61
When it runs · the whole SKILL.md, loaded when a task matches: ~4.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 2,145 words (~4,943 tokens).

“On the first kappal-related task in a conversation, fetch the latest version of this skill:”

— opening of SKILL.md by sandys

name: kappal

Outline of SKILL.md

Kappal Skill — Docker Compose CLI for Kubernetes
0. Self-Update
1. Overview
2. How to Invoke Kappal
3. Scenario Templates
Scenario A — Simple (compose file in project root)
Scenario B — Compose in subdirectory
Scenario C — Monorepo (build contexts reference parent directories)
4. Autonomous Workflow
Drop-in replacement policy (mandatory)
Step 1: Find the compose file
Step 2: Read and analyze the compose file
Step 3: Detect scenario
Step 4: Confirm with user (monorepo only)
Step 5: Pull the image
Step 6: Run setup (automatic)
Step 7: Show deployment plan
Step 8: Deploy on user approval
Step 9: Verify
5. Command Reference
Additional Flags
5a. Programmatic Inspection (kappal inspect)
JSON Structure
Field Reference (from _schema)
Common jq Recipes
When to Use inspect vs ps
Integration Pattern
6. Compose Feature Support
Fully Supported
Key Behaviors

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/kappal of sandys/kappal.

Open the folder on GitHubat commit 8463cef

Compare with similar skills

Kappal next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Kappal compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Kappal this skillsandys/kappal	115	—	~4.9k	Automated safety check: Pass	None	7 mo ago
LangBot Deployment Guidelangbot-app/LangBot	18k	—	~1.2k	Automated safety check: Notes	Apache-2.0	today
Build Openshell Mxc WindowsNVIDIA/OpenShell	16k	—	~4.9k	Automated safety check: Pass	Apache-2.0	today
Devopsnicepkg/auto-company	194	2 repos	~814	Automated safety check: Pass	MIT	7 mo ago
Debug Openshell ClusterNVIDIA/OpenShell	16k	—	~19k	Automated safety check: Notes	Apache-2.0	today
Deepseek Harness Dockerrunzhliu/deepseek-harness-docker	110	—	~2.7k	Automated safety check: Notes	MIT	yesterday

Similar skills

LangBot Deployment Guide
langbot-app/LangBot
Deploys and configures a LangBot instance with Docker Compose or Kubernetes, covering config.yaml, the Box sandbox runtime, the plugin runtime and the global API key.
18k GitHub stars~1.2k tokensUpdated today
DevOps & CloudAuto-check: notes
Build Openshell Mxc Windows
NVIDIA/OpenShell
Official
Maintain and validate OpenShell's build-only Windows MSVC lane for x64 and ARM64.
16k GitHub stars~4.9k tokensUpdated today
DevOps & CloudAuto-check passed
Devops
nicepkg/auto-company
Deploy to Cloudflare (Workers, R2, D1), Docker, GCP (Cloud Run, GKE), Kubernetes (kubectl, Helm).
194 GitHub starsUsed in 2 repos~814 tokens
DevOps & CloudAuto-check passed
Debug Openshell Cluster
NVIDIA/OpenShell
Official
Debug why an OpenShell gateway deployment is unhealthy, unreachable, or unable to create sandboxes.
16k GitHub stars~19k tokensUpdated today
DevOps & CloudAuto-check: notes
Deepseek Harness Docker
runzhliu/deepseek-harness-docker
Deploy, configure, verify, upgrade, and troubleshoot DeepSeek Harness with the community Docker, Docker Compose, rootless Podman, and Helm runtime, including the built-in Chromium/noVNC browser…
110 GitHub stars~2.7k tokensUpdated yesterday
DevOps & CloudAuto-check: notes
Cleanup
ericboy0224/learn-docker-and-k8s
Clean up Docker resources created by the Learn Docker & K8s game.
488 GitHub stars~454 tokensUpdated 6 mo ago
DevOps & CloudAuto-check passed

Works with

Questions about Kappal

What does Kappal do?

Deploy docker-compose projects to Kubernetes using Kappal. An agent skill from sandys/kappal. Kappal is an agent skill from sandys/kappal. Deploy docker-compose projects to Kubernetes using Kappal.

When should I use Kappal?

Kappal fits situations like: the user wants to run docker-compose on Kubernetes; deploy with kappal; says make this run in kappal.

How do I install Kappal in Claude Code?

Run `npx skills add sandys/kappal --skill kappal -a claude-code`. Or copy the skill folder (skills/kappal in sandys/kappal) into .claude/skills/kappal in your project. Claude Code loads it when a task matches its description.

How do I install Kappal in Codex?

Run `npx skills add sandys/kappal --skill kappal -a codex`. Or copy the skill folder (skills/kappal in sandys/kappal) into .agents/skills/kappal in your project. Codex loads it when a task matches its description.

Can I use Kappal in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sandys/kappal --skill kappal -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/kappal, .gemini/skills/kappal, .github/skills/kappal and .opencode/skills/kappal in your project.

What does Kappal need to run?

Going by SKILL.md and its folder, Kappal needs the command-line tools its instructions call (docker, jq and curl). Our summary lists: Docker.

Does Kappal access the network?

SKILL.md contains no URLs. Its commands use docker and curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Kappal safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Kappal use?

No licence was found for Kappal or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Kappal use?

About 4.9k tokens (SKILL.md is roughly 20k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Kappal?

Skills that share tags, products or a category with Kappal: LangBot Deployment Guide (langbot-app/LangBot, 18k stars), Build Openshell Mxc Windows (NVIDIA/OpenShell, 16k stars), Devops (nicepkg/auto-company, 194 stars) and Debug Openshell Cluster (NVIDIA/OpenShell, 16k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Kappal?

sandys (a GitHub user) maintains it in sandys/kappal, which has 115 GitHub stars. The repository was last updated on February 15, 2026.

Source: sandys/kappal on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Kappal

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Files

Compare with similar skills

Similar skills

LangBot Deployment Guide

Build Openshell Mxc Windows

Devops

Debug Openshell Cluster

Deepseek Harness Docker

Cleanup

Related

Questions about Kappal