# Sounio Language > Write and edit Sounio `.sio` code, examples, and language docs; enforce Sounio-native syntax (`var`, `&!`, explicit `with` effects) and reduce Rust-like drift across `examples/`, `tests/`, and `docs/`. Use when this capability is needed. - Skill: `tomevault-io/sounio-language` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/sounio-language` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/sounio-language/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/sounio-language --- # Sounio Language ## Overview Write correct Sounio and keep language-facing materials aligned with what the compiler actually accepts. ## Workflow ### 1) Decide “implemented” vs “aspirational” - Read `compiler/docs/KNOWN_LIMITATIONS.md` and `docs/MV_CORE_CHECKLIST.md`. - If you touch docs/examples, prefer aligning them to the compiler over adding new surface syntax. ### 2) Anchor to canonical examples - For real, compilable syntax patterns, mirror `tests/run-pass/` and `stdlib/` (not blog-like examples). - When unsure about a construct, search for it in: - `docs/LLM_PROGRAMMING_GUIDE.md` - `compiler/src/parser/tests/` ### 3) Enforce Sounio-native syntax (no Rust drift) - Use `var` (not `let mut`) - Use `&!T` (not `&mut T`) - Avoid Rust macros in `.sio` (`println!`, `assert!`, attributes like `#[...]`) - If drift appears, run the scan script and then update the file(s) to match Sounio conventions. ### 4) Validate quickly - Prefer `cd compiler && cargo run -- check ` for a single-file sanity check. - Add/adjust a focused test in `tests/` when fixing language-facing behavior. ## References - Repo navigation: `references/repo-navigation.md` - Drift patterns + quick `rg` queries: `references/drift-scan-patterns.md` ## Scripts - `scripts/scan_syntax_drift.py` scans `docs/`, `examples/`, `tests/`, `stdlib/` for Rust-like constructs and doc drift. --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/sounio-lang) — claim your Tome and manage your conversions.