kurtosis-tech/import-compose
skills/import-compose/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add kurtosis-tech/kurtosis import-composeInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 15, 2026, 1:20 PM6.7s1 file scanned
SKILL.md
- name:
- import-compose
- description:
- 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.
- compatibility:
- Requires kurtosis CLI with a running engine.
- author:
- ethpandaops
- version:
- 1.0
Import Compose
Import Docker Compose files into Kurtosis, either running them directly or converting to Starlark.
Run a Docker Compose file
kurtosis import docker-compose.yml
This creates an enclave and runs all services defined in the Compose file.
Run with a named enclave
kurtosis import -n my-enclave docker-compose.yml
Convert only (don't run)
Generate Starlark code from a Compose file without executing:
kurtosis import -c docker-compose.yml
This outputs Starlark that you can save and customize.
Custom .env file
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)
Related Skills
kurtosis-tech/starlark-dev
development
VerifiedTrustedCommunity
Develop and debug Kurtosis Starlark packages. Create packages from scratch, understand the plan-based execution model, use print() debugging, handle future references, and test packages locally. Use when writing or troubleshooting .star files.
534SKILL.mdUpdated Apr 15, 2026
kurtosis-tech/service-manage
data-ai
VerifiedTrustedCommunity
Manage services in Kurtosis enclaves. Add, inspect, stop, start, remove, update services. View logs, shell into containers, and execute commands. Use when you need to interact with running services.
534SKILL.mdUpdated Apr 15, 2026
kurtosis-tech/run-package
content-media
VerifiedTrustedCommunity
Run Starlark scripts and packages with kurtosis run. Covers all flags including dry-run, args-file, parallel execution, image download modes, verbosity levels, and production mode. Use when executing Kurtosis packages locally or from GitHub.
534SKILL.mdUpdated Apr 15, 2026
kurtosis-tech/portal
testing
VerifiedTrustedCommunity
Manage Kurtosis Portal for remote context access. Start, stop, and check status of the Portal daemon that enables communication with remote Kurtosis servers. Use when working with remote Kurtosis contexts.
534SKILL.mdUpdated Apr 15, 2026