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…

Skill by Sounio-lang

IndexedApache-2.0★ 12

Write a review

Install

Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install skill/sounio-lang-sounio-language

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

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 cases: writing

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.

Tools: No tools found
Secrets: None asked for
Install scripts: None found
Runs as: Python package

Network hosts it talks to 1

codeload.github.com · found in install command

Files it touches

~/.claude/skills/sounio-language

What's inside

Skill name: sounio-language
Description: 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/`.
License: Apache-2.0
Instructions: 42 lines in SKILL.md · view on GitHub

Before installing

Ships executable scripts

Files (4)

SKILL.md
drift-scan-patterns.md · references/
repo-navigation.md · references/
scan_syntax_drift.py · scripts/

SKILL.md (first lines)

# 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 `docs/compiler/KNOWN_LIMITATIONS.md` and `docs/implementation/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/guide/LLM_PROGRAMMING_GUIDE.md`
  - `tests/run-pass/`

### 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 `./bin/souc check <file.sio>` 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

- `skills/sounio-language/scripts/scan_syntax_drift.py` scans `docs/`, `examples/`, `tests/`, `stdlib/` for Rust-like constructs and doc drift. `scripts/dev/fast_gate.sh` runs that script.

From Sounio-lang/sounio, Apache-2.0.

Signals

Stars: 12
Forks: 3
Open issues: 24
Last commit (this folder): Sep 19, 2026 (1 month ago)
Last release: May 18, 2026 (5 months ago)

From GitHub (fetched Oct 24, 2026).

Details

License: Apache-2.0
Repository: github.com/Sounio-lang/sounio
Website: www.souniolang.org
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: GitHub github-graphql

More from Sounio-lang

Cite this page

sounio-language skill. Agent Mart. https://agentmart.dev/skills/sounio-lang-sounio-language (last updated 2026-10-24)