# Neva Authoring

> Neva Authoring is an Agent Skill for documents published in the nevalang/neva repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use when editing, reviewing, or generating .neva source files or Neva snippets in docs/tests. Covers syntax, style, and validation expectations.

- Skill name: `neva-authoring`
- Category: [Documents](https://www.openparable.com/skill/documents/1)
- Source: https://github.com/nevalang/neva/blob/HEAD/.codex/skills/neva-authoring/SKILL.md
- Repository: nevalang/neva (1,074 GitHub stars when collected)

## SKILL.md

# Neva Authoring

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

## Rules

- Follow the nearest `AGENTS.md` as scoped source of truth.
- Source of truth for style: `docs/style_guide.md`.
- 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.

---

Source: https://www.openparable.com/skill/documents/neva-authoring (OpenParable). Cite the canonical URL above.