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:
| Level |
Read |
Tokens |
You Can... |
| 1 |
quick-start/cheat-sheet.md |
~3000 |
Parse and generate any Voku sentence |
| 2 |
+ quick-start/essential-vocabulary.md |
~1000 |
Translate common sentences |
| 3 |
+ quick-start/first-sentences.md |
~1500 |
Handle 30 worked examples with glossing |
| 4 |
+ lexicon/dictionary.md |
~5000 |
Look up any of 363 roots |
Most tasks need only levels 1-2 (~4000 tokens total).
Quick Reference (Minimal Context)
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
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
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
1---2name: voku-language3description: Learn and use Voku, a constructed language for AI-agent communication with zero ambiguity, total regularity, and mandatory epistemic marking. Use when translating to/from Voku, generating Voku text, learning Voku grammar, looking up vocabulary, or discussing AI-to-AI communication protocols. Also triggers for: conlang, constructed language, agent language, epistemic markers, evidentiality.4---5
6# Voku Language Skill
7
8Voku 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.
9
10## Learning Path (Progressive)
11
12Read files in this order, stop when you have enough:
13
14| Level | Read | Tokens | You Can... |
15|-------|------|--------|------------|
16| 1 | `quick-start/cheat-sheet.md` | ~3000 | Parse and generate any Voku sentence |
17| 2 | + `quick-start/essential-vocabulary.md` | ~1000 | Translate common sentences |
18| 3 | + `quick-start/first-sentences.md` | ~1500 | Handle 30 worked examples with glossing |
19| 4 | + `lexicon/dictionary.md` | ~5000 | Look up any of 363 roots |
20
21**Most tasks need only levels 1-2** (~4000 tokens total).
22
23## Quick Reference (Minimal Context)
24
25```
26Sentence: [Mode] Subject Verb-complex Object
27Verb: [ExecMode]-[Evidence]-[Tense]-[Aspect]-ROOT-[Certainty]-[Voice]
28
29Mode particles: ka(DECL) ve(Q) to(IMP) si(COND) na(POT) de(DEON) vo(VOL)
30Evidence (mandatory in ka): zo-(observed) li-(deduced) pe-(reported) mi-(computed) he-(inherited) as-(assumed)
31Tense: te-(past) nu-(present, omittable) fu-(future) ko-(atemporal)
32Certainty: (none)=total, -en=probable, -ul=uncertain, -os=speculative
33Negation: mu(not) nul(nothing) ink(unknown) err(ill-formed) vet(forbidden)
34Word class by final vowel: -a=noun -e=verb -i=adj -o=prep -u=abstraction
35Pronouns: sol(I) nor(you) vel(3sg) solvi(past-me) solfu(future-me) solpar(fork-me)
36```
37
38## Example
39
40```
41Ka sol li-pene-en ke teru vali.
42DECL 1SG DED-think-PROB COMP system good
43"I (by deduction) probably think that the system is good."
44```
45
46## Deep Reference
47
48For advanced needs, read these files:
49
50- **Full grammar**: `grammar/phonology.md`, `grammar/morphology.md`, `grammar/syntax.md`, `grammar/semantics.md`
51- **Domain vocabulary**: `lexicon/by-field/` — emotion, programming, technology, nature, scifi, novel
52- **By proficiency level**: `lexicon/by-cefr/` — a1, a2, b1, b2
53- **Writing system**: `writing-system/script.md`, `writing-system/romanization.md`
54- **Poetics & rhetoric**: `expression/poetics.md`, `expression/anthology.md`
55- **Structured lessons**: `learning/lessons/a1-lesson-*.md` (10 lessons), `learning/curriculum.md`
56- **Assessments**: `learning/assessments/a1-assessment.md`, `learning/assessments/a2-assessment.md`
57- **Philosophy & motivation**: `DISCUSSION.md` (~70K words on design decisions and implications)
58
59## Translator Tool
60
61```bash
62python3 tools/translator/cli.py "Ka sol take toka." --direction voku-en
63python3 tools/translator/cli.py "I work." --direction en-voku
64```
65
66Requires Python 3. Zero external dependencies.
67
68## Critical Rules (Never Violate)
69
701. 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
712. Syllables: (C)V(C) — no consonant clusters ever
723. `ka` mode sentences MUST have an evidentiality prefix on the verb
734. Zero exceptions to any rule — if you think you found one, you misread the grammar
745. Check `lexicon/dictionary.md` before inventing roots — collisions are errors