Kurtosis lint

Lint and format Kurtosis Starlark files. Check syntax, validate docstrings, and auto-format .star files. Use when writing or reviewing Starlark packages to ensure code quality.

install

source · Clone the upstream repo

git clone https://github.com/kurtosis-tech/kurtosis

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/kurtosis-tech/kurtosis "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/lint" ~/.claude/skills/kurtosis-tech-kurtosis-lint && rm -rf "$T"

manifest: skills/lint/SKILL.md

Lint

Lint and format Kurtosis Starlark (.star) files.

Check formatting

# Check a single file
kurtosis lint main.star

# Check a directory
kurtosis lint ./my-package/

# Check multiple files
kurtosis lint main.star lib.star helpers.star

Returns non-zero exit code if formatting issues are found.

Auto-format

Fix formatting in place:

kurtosis lint -f main.star

# Format all files in a package
kurtosis lint -f ./my-package/

Check docstrings

Validate that the main function has a proper docstring:

kurtosis lint -c ./my-package/main.star

# Or point to the package directory
kurtosis lint -c ./my-package/

This checks that the

run

function has a valid docstring describing its parameters.

CI integration

# Check formatting (fails if not formatted)
kurtosis lint ./my-package/

# Check docstrings
kurtosis lint -c ./my-package/

# Fix-and-retry pattern: auto-fix, then re-lint to verify
kurtosis lint -f ./my-package/
kurtosis lint ./my-package/