keloslisted
Install: claude install-skill kelos-dev/kelos
# Kelos Skill
Use this skill when you need to author, debug, or operate Kelos resources
(Task, Workspace, AgentConfig, TaskSpawner) on a Kubernetes cluster.
## Installing Kelos
Install the controller and CRDs into a Kubernetes cluster:
```bash
kelos install
```
Uninstall:
```bash
kelos uninstall
```
Initialize a local config file at `~/.kelos/config.yaml`:
```bash
kelos init
```
## Core Resources
Kelos defines four custom resources:
| Resource | Purpose |
|----------|---------|
| **Task** | A single agent run — prompt, credentials, optional workspace and config |
| **Workspace** | A git repository to clone for the agent |
| **AgentConfig** | Reusable instructions, skills, agents, MCP servers |
| **TaskSpawner** | Automatically creates Tasks from GitHub issues, Jira tickets, or cron |
### Task
A Task runs an AI agent with a prompt. Key fields:
- `spec.type` (required): `claude-code`, `codex`, `gemini`, `opencode`, or `cursor`
- `spec.prompt` (required): The task prompt
- `spec.credentials` (required): `type` (`api-key` or `oauth`) and `secretRef.name`
- `spec.workspaceRef.name`: Reference to a Workspace
- `spec.agentConfigRef.name`: Reference to an AgentConfig
- `spec.branch`: Git branch mutex — only one Task with the same branch runs at a time
- `spec.dependsOn`: Task names that must succeed first
- `spec.ttlSecondsAfterFinished`: Auto-delete after completion (seconds)
- `spec.model`: Model override
- `spec.effort`: Agent reasoning effort
- `spec.podOverrides`: