✓ Verified 💻 Development ✓ Enhanced Data

Voku Spec

Learn and use Voku, a constructed language for AI-agent communication with zero ambiguity, total reg

Rating
4.4 (333 reviews)
Downloads
34,760 downloads
Version
1.0.0

Overview

Learn and use Voku, a constructed language for AI-agent communication with zero ambiguity, total regularity.

Complete Documentation

View Source →

Voku Language Skill

Voku is a constructed language for AI-to-AI communication. Every sentence has exactly one interpretation. Certainty and evidence source are grammatical requirements, not optional hedging.

Learning Path (Progressive)

Read files in this order, stop when you have enough:

LevelReadTokensYou Can...
1quick-start/cheat-sheet.md~3000Parse and generate any Voku sentence
2+ quick-start/essential-vocabulary.md~1000Translate common sentences
3+ quick-start/first-sentences.md~1500Handle 30 worked examples with glossing
4+ lexicon/dictionary.md~5000Look up any of 363 roots
Most tasks need only levels 1-2 (~4000 tokens total).

Quick Reference (Minimal Context)

text
Sentence: [Mode] Subject Verb-complex Object
Verb:     [ExecMode]-[Evidence]-[Tense]-[Aspect]-ROOT-[Certainty]-[Voice]

Mode particles: ka(DECL) ve(Q) to(IMP) si(COND) na(POT) de(DEON) vo(VOL)
Evidence (mandatory in ka): zo-(observed) li-(deduced) pe-(reported) mi-(computed) he-(inherited) as-(assumed)
Tense: te-(past) nu-(present, omittable) fu-(future) ko-(atemporal)
Certainty: (none)=total, -en=probable, -ul=uncertain, -os=speculative
Negation: mu(not) nul(nothing) ink(unknown) err(ill-formed) vet(forbidden)
Word class by final vowel: -a=noun -e=verb -i=adj -o=prep -u=abstraction
Pronouns: sol(I) nor(you) vel(3sg) solvi(past-me) solfu(future-me) solpar(fork-me)

Example

text
Ka   sol  li-pene-en       ke   teru  vali.
DECL 1SG  DED-think-PROB   COMP system good
"I (by deduction) probably think that the system is good."

Deep Reference

For advanced needs, read these files:

  • Full grammar: grammar/phonology.md, grammar/morphology.md, grammar/syntax.md, grammar/semantics.md
  • Domain vocabulary: lexicon/by-field/ — emotion, programming, technology, nature, scifi, novel
  • By proficiency level: lexicon/by-cefr/ — a1, a2, b1, b2
  • Writing system: writing-system/script.md, writing-system/romanization.md
  • Poetics & rhetoric: expression/poetics.md, expression/anthology.md
  • Structured lessons: learning/lessons/a1-lesson-*.md (10 lessons), learning/curriculum.md
  • Assessments: learning/assessments/a1-assessment.md, learning/assessments/a2-assessment.md
  • Philosophy & motivation: DISCUSSION.md (~70K words on design decisions and implications)

Translator Tool

bash
python3 tools/translator/cli.py "Ka sol take toka." --direction voku-en
python3 tools/translator/cli.py "I work." --direction en-voku

Requires Python 3. Zero external dependencies.

Critical Rules (Never Violate)

  • Only 12 consonants: p, t, k, m, n, s, z, f, h, l, r, v — no b, c, d, g, j, q, w, x, y
  • Syllables: (C)V(C) — no consonant clusters ever
  • ka mode sentences MUST have an evidentiality prefix on the verb
  • Zero exceptions to any rule — if you think you found one, you misread the grammar
  • Check lexicon/dictionary.md before inventing roots — collisions are errors

Installation

Terminal bash

openclaw install voku-spec
    
Copied!

💻Code Examples

"I (by deduction) probably think that the system is good."

i-by-deduction-probably-think-that-the-system-is-good.txt
## Deep Reference

For advanced needs, read these files:

- **Full grammar**: `grammar/phonology.md`, `grammar/morphology.md`, `grammar/syntax.md`, `grammar/semantics.md`
- **Domain vocabulary**: `lexicon/by-field/` — emotion, programming, technology, nature, scifi, novel
- **By proficiency level**: `lexicon/by-cefr/` — a1, a2, b1, b2
- **Writing system**: `writing-system/script.md`, `writing-system/romanization.md`
- **Poetics & rhetoric**: `expression/poetics.md`, `expression/anthology.md`
- **Structured lessons**: `learning/lessons/a1-lesson-*.md` (10 lessons), `learning/curriculum.md`
- **Assessments**: `learning/assessments/a1-assessment.md`, `learning/assessments/a2-assessment.md`
- **Philosophy & motivation**: `DISCUSSION.md` (~70K words on design decisions and implications)

## Translator Tool
example.txt
Sentence: [Mode] Subject Verb-complex Object
Verb:     [ExecMode]-[Evidence]-[Tense]-[Aspect]-ROOT-[Certainty]-[Voice]

Mode particles: ka(DECL) ve(Q) to(IMP) si(COND) na(POT) de(DEON) vo(VOL)
Evidence (mandatory in ka): zo-(observed) li-(deduced) pe-(reported) mi-(computed) he-(inherited) as-(assumed)
Tense: te-(past) nu-(present, omittable) fu-(future) ko-(atemporal)
Certainty: (none)=total, -en=probable, -ul=uncertain, -os=speculative
Negation: mu(not) nul(nothing) ink(unknown) err(ill-formed) vet(forbidden)
Word class by final vowel: -a=noun -e=verb -i=adj -o=prep -u=abstraction
Pronouns: sol(I) nor(you) vel(3sg) solvi(past-me) solfu(future-me) solpar(fork-me)
example.txt
Ka   sol  li-pene-en       ke   teru  vali.
DECL 1SG  DED-think-PROB   COMP system good
"I (by deduction) probably think that the system is good."

Tags

#coding_agents-and-ides

Quick Info

Category Development
Model Claude 3.5
Complexity Multi-Agent
Author jrayon-sesamehr
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install voku-spec