---
name: "neva-language"
description: "Use for Neva source or snippets: authoring, refactoring, debugging, or review."
---

# Neva Language

Use this skill for changes touching `*.neva` or Neva code snippets.

## CLI Discovery

- Use `neva --help` to list commands and global options.
- Use `neva <command> --help` before relying on a command's flags or argument
  contract.
- During repository development, run `go run ./cmd/neva --help` or
  `go run ./cmd/neva <command> --help` when a local binary is unavailable.
- `neva doc [package/path] [.] <pattern>` searches the bundled standard
  library; use it to discover existing components before adding one.

## Rules

- Read `docs/user/style_guide.md` before editing.
- Keep edited `.neva` files syntactically valid.
- If syntax is uncertain, consult `internal/compiler/parser/neva.g4` and nearby
  `.neva` examples before editing.
- When feasible, validate changed Neva programs by compiling or running them.
- When editing documentation or snippets, prefer a quick local compile/run check
  of an equivalent minimal example.