multiAI Summary Pending

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.

528 stars

bykurtosis-tech

View on GitHub Installation ↓

Installation

Claude Code / Cursor / Codex

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

Manual Installation

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

How lint Compares

Feature / Agent	lint	Standard Approach
Platform Support	multi	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	Unknown	N/A

Frequently Asked Questions

What does this skill do?

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.

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

# Lint

Lint and format Kurtosis Starlark (.star) files.

## Check formatting

```bash
# 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:

```bash
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:

```bash
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

```bash
# 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/
```