multiAI Summary Pending

import-compose

Import Docker Compose files into Kurtosis. Convert docker-compose.yml to Starlark packages or run them directly. Use when migrating existing Docker Compose workflows to Kurtosis.

528 stars

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/import-compose/SKILL.md --create-dirs "https://raw.githubusercontent.com/kurtosis-tech/kurtosis/main/skills/import-compose/SKILL.md"

Manual Installation

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

How import-compose Compares

Feature / Agentimport-composeStandard Approach
Platform SupportmultiLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Import Docker Compose files into Kurtosis. Convert docker-compose.yml to Starlark packages or run them directly. Use when migrating existing Docker Compose workflows to Kurtosis.

Which AI agents support this skill?

This skill is compatible with multi.

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

# Import Compose

Import Docker Compose files into Kurtosis, either running them directly or converting to Starlark.

## Run a Docker Compose file

```bash
kurtosis import docker-compose.yml
```

This creates an enclave and runs all services defined in the Compose file.

## Run with a named enclave

```bash
kurtosis import -n my-enclave docker-compose.yml
```

## Convert only (don't run)

Generate Starlark code from a Compose file without executing:

```bash
kurtosis import -c docker-compose.yml
```

This outputs Starlark that you can save and customize.

## Custom .env file

```bash
kurtosis import -e ./custom.env docker-compose.yml
```

Default is `.env` in the current directory.

## Supported Compose features

Most common Compose features are supported:
- Services with images
- Port mappings
- Environment variables
- Volumes (converted to file artifacts)
- Depends-on (converted to service ordering)
- Networks (Kurtosis handles networking automatically)

## Limitations

- Build directives are not supported (images must be pre-built)
- Some advanced networking features may not translate directly
- Volume mounts become file artifacts (not persistent volumes)