k8s-gen

Generate Kubernetes manifests from docker-compose or descriptions. Use when deploying to K8s.

16 stars

Best use case

k8s-gen is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Generate Kubernetes manifests from docker-compose or descriptions. Use when deploying to K8s.

Teams using k8s-gen should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/k8s-gen/SKILL.md --create-dirs "https://raw.githubusercontent.com/diegosouzapw/awesome-omni-skill/main/skills/devops/k8s-gen/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/k8s-gen/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How k8s-gen Compares

Feature / Agentk8s-genStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Generate Kubernetes manifests from docker-compose or descriptions. Use when deploying to K8s.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# K8s Generator

Translating docker-compose to Kubernetes manifests is tedious YAML shuffling. Feed in your compose file and get proper K8s manifests back.

**One command. Zero config. Just works.**

## Quick Start

```bash
npx ai-k8s docker-compose.yml
```

## What It Does

- Converts docker-compose to Kubernetes manifests
- Generates from plain English descriptions
- Creates Deployments, Services, ConfigMaps
- Handles secrets and persistent volumes

## Usage Examples

```bash
# From docker-compose
npx ai-k8s docker-compose.yml --namespace production

# From description
npx ai-k8s "3 replicas of a node app with redis and postgres"

# Save output
npx ai-k8s docker-compose.yml -o k8s-manifests.yml
```

## Best Practices

- **Use namespaces** - organize your resources
- **Set resource limits** - prevent runaway pods
- **Add health checks** - liveness and readiness probes
- **Use secrets properly** - don't hardcode credentials

## When to Use This

- Migrating from docker-compose to Kubernetes
- Setting up new K8s deployments
- Learning Kubernetes manifest structure
- Quick prototyping before fine-tuning

## Part of the LXGIC Dev Toolkit

This is one of 110+ free developer tools built by LXGIC Studios. No paywalls, no sign-ups, no API keys on free tiers. Just tools that work.

**Find more:**
- GitHub: https://github.com/LXGIC-Studios
- Twitter: https://x.com/lxgicstudios
- Substack: https://lxgicstudios.substack.com
- Website: https://lxgicstudios.com

## Requirements

No install needed. Just run with npx. Node.js 18+ recommended. Needs OPENAI_API_KEY environment variable.

```bash
npx ai-k8s --help
```

## How It Works

Parses your docker-compose.yml or description, understands the services and their relationships, then generates equivalent Kubernetes resources with proper configuration.

## License

MIT. Free forever. Use it however you want.

Related Skills

bgo

10
from diegosouzapw/awesome-omni-skill

Automates the complete Blender build-go workflow, from building and packaging your extension/add-on to removing old versions, installing, enabling, and launching Blender for quick testing and iteration.

Coding & Development

kubernetes-deployment

16
from diegosouzapw/awesome-omni-skill

Deploy, manage, and scale applications on Kubernetes clusters using manifests, Helm charts, and autoscaling configurations.

kubernetes-deployer

16
from diegosouzapw/awesome-omni-skill

Package and deploy applications to Kubernetes with Dockerfiles, Helm charts, and local Minikube deployment. Use when containerizing applications, creating Kubernetes manifests, setting up Helm charts, deploying to Minikube, or preparing cloud-ready configurations. Focuses on local-first deployment with stateless services.

kubernetes-architect

16
from diegosouzapw/awesome-omni-skill

Expert Kubernetes architect specializing in cloud-native infrastructure, advanced GitOps workflows (ArgoCD/Flux), and enterprise container orchestration.

kubectl-skill

16
from diegosouzapw/awesome-omni-skill

Execute and manage Kubernetes clusters via kubectl commands. Query resources, deploy applications, debug containers, manage configurations, and monitor cluster health. Use when working with Kubernetes clusters, containers, deployments, or pod diagnostics.

konto-deploy

16
from diegosouzapw/awesome-omni-skill

Deploy and run Konto (personal finance dashboard) locally. Use when setting up a new Konto instance, troubleshooting installation, or helping users get started with Konto.

kind

16
from diegosouzapw/awesome-omni-skill

Manage Kind (Kubernetes in Docker) clusters for local Kagenti development and testing.

Kind Local Kubernetes

16
from diegosouzapw/awesome-omni-skill

This skill should be used when the user asks to "setup Kind", "local Kubernetes", "Kind cluster", "multi-node cluster", "Kubernetes development", "k8s local environment", or works with local Kubernetes clusters using Kind.

keycloak

16
from diegosouzapw/awesome-omni-skill

Keycloak identity and access management. Use for SSO.

keycloak-expert

16
from diegosouzapw/awesome-omni-skill

This skill should be used when the user asks to 'configure Keycloak', 'set up ABAC', 'create Keycloak realm', 'integrate Azure AD with Keycloak', 'implement authorization services', 'configure OIDC client', 'create Keycloak policies', 'set up UMA/RPT tokens', 'deploy Keycloak on OpenShift', 'integrate Spring Security with Keycloak', 'configure NextAuth.js with Keycloak', 'create protocol mappers', 'map Azure groups to roles', or needs guidance on Keycloak realm/client configuration, ABAC policies and permissions, identity provider federation, or Configuration as Code patterns.

karpathy

16
from diegosouzapw/awesome-omni-skill

Coding principles for simplicity, clarity, and surgical precision. Use when you want Claude to think before coding, keep solutions minimal, make surgical changes, and define verifiable success criteria. Triggers on: karpathy mode, think before coding, simplicity first, surgical changes.

kamal-deploy

16
from diegosouzapw/awesome-omni-skill

Expert-level Kamal deployment guidance for deploying containerized applications to any server. Use this skill when users ask about Kamal, container deployment, zero-downtime deployments, deploying Rails/web apps to VPS/cloud servers, kamal setup, kamal deploy, Docker deployment without Kubernetes, or deploying to Hetzner/DigitalOcean/AWS with Kamal. Also use when users mention DHH's deployment tool, 37signals deployment, or want an alternative to Heroku/Render/Vercel with self-hosted infrastructure.