skills/lint/SKILL.md
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.
npx skillsauth add kurtosis-tech/kurtosis lintInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Lint and format Kurtosis Starlark (.star) files.
# 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.
Fix formatting in place:
kurtosis lint -f main.star
# Format all files in a package
kurtosis lint -f ./my-package/
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.
# 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/
development
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.
data-ai
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.
content-media
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.
testing
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.