Agent skills for managing KubeOpenCode AI tasks and agents on Kubernetes.
These skills follow the Agent Skills specification so they can be used by any skills-compatible agent, including Claude Code, OpenCode, and Codex CLI.
First, add the marketplace source:
/plugin marketplace add kubeopencode/skills
Then, install the plugin:
/plugin install kubeopencode@kubeopencode-skills
npx skills add git@github.com:kubeopencode/skills.git
Clone this repo into your project's .claude directory (or your home directory's ~/.claude):
git clone https://github.com/kubeopencode/skills.git /path/to/your/project/.claudeOr copy just the skills/ directory if you already have a .claude folder:
git clone https://github.com/kubeopencode/skills.git /tmp/kubeopencode-skills
cp -r /tmp/kubeopencode-skills/kubeopencode/skills/ /path/to/your/project/.claude/skills/See the Claude Skills documentation for more details.
Clone the entire repo into the OpenCode skills directory (~/.opencode/skills/):
git clone https://github.com/kubeopencode/skills.git ~/.opencode/skills/kubeopencode-skillsDo not copy only the inner skills/ folder — clone the full repo so the directory structure is ~/.opencode/skills/kubeopencode-skills/kubeopencode/skills/<skill-name>/SKILL.md.
OpenCode auto-discovers all SKILL.md files under ~/.opencode/skills/. No changes to opencode.json or any config file are needed. Skills become available after restarting OpenCode.
Copy the skills/ directory into your Codex skills path (typically ~/.codex/skills):
git clone https://github.com/kubeopencode/skills.git /tmp/kubeopencode-skills
cp -r /tmp/kubeopencode-skills/kubeopencode/skills/ ~/.codex/skills/See the Agent Skills specification for the standard skill format.
| Skill | Description |
|---|---|
| koc | Manage KubeOpenCode AI tasks and agents on Kubernetes — create tasks, list agents, check status, view logs, stop tasks, monitor progress, and schedule recurring tasks |
The koc skill requires the following environment variables:
| Variable | Required | Description |
|---|---|---|
KUBEOPENCODE_KUBECONFIG |
Yes | Path to kubeconfig for the KubeOpenCode cluster |
KUBEOPENCODE_DEFAULT_NAMESPACE |
No | Default namespace for all operations (Tasks, Agents, CronJobs) |
Set these in your shell profile or project-level environment configuration.
Once installed, your AI coding agent can:
- List agents — see what AI agents are available on the cluster
- Create tasks — run AI-powered tasks on Kubernetes with automatic agent matching
- Monitor tasks — track task progress with automatic polling
- View logs — fetch task output from pod logs
- Stop tasks — gracefully stop running tasks
- Schedule tasks — set up recurring tasks with natural language schedules
Example prompts:
- "What agents are available on the cluster?"
- "Create a task to fix the login bug using the go-agent"
- "What's the status of my task?"
- "Show me the logs for task fix-bug-abc1"
- "Stop the running task"
- "Schedule a daily task to check for dependency updates using the go-agent"
Apache License 2.0 - see LICENSE for details.