voku-specLearn and use Voku, a constructed language for AI-agent communication with zero ambiguity, total regularity, and mandatory epistemic marking. Use when transl...
Install via ClawdBot CLI:
clawdbot install jrayon-sesamehr/voku-specVoku 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.
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).
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)
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."
For advanced needs, read these files:
grammar/phonology.md, grammar/morphology.md, grammar/syntax.md, grammar/semantics.mdlexicon/by-field/ — emotion, programming, technology, nature, scifi, novellexicon/by-cefr/ — a1, a2, b1, b2writing-system/script.md, writing-system/romanization.mdexpression/poetics.md, expression/anthology.mdlearning/lessons/a1-lesson-*.md (10 lessons), learning/curriculum.mdlearning/assessments/a1-assessment.md, learning/assessments/a2-assessment.mdDISCUSSION.md (~70K words on design decisions and implications)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.
ka mode sentences MUST have an evidentiality prefix on the verblexicon/dictionary.md before inventing roots — collisions are errorsGenerated Feb 24, 2026
AI agents use Voku to generate unambiguous logs and error reports, ensuring precise communication during debugging. This reduces misinterpretation in automated diagnostics and facilitates clear root cause analysis in distributed systems.
Organizations employ Voku to draft contracts or regulatory reports where certainty and evidence sources must be explicitly stated. This minimizes legal ambiguities and ensures compliance with strict documentation standards.
Researchers use Voku to share findings with mandatory epistemic markers, clarifying evidence types like observed or computed data. This enhances reproducibility and reduces miscommunication in interdisciplinary teams.
AI-powered support agents communicate in Voku to provide clear, unambiguous responses with explicit certainty levels. This improves customer trust and reduces errors in handling queries across languages.
Developers integrate Voku into communication protocols for autonomous systems, ensuring zero ambiguity in commands and data exchanges. This is critical for safety in robotics or IoT networks.
Offer a cloud-based API for real-time Voku translation and generation, charging per API call or monthly subscription. This targets developers building AI systems that require precise inter-agent communication.
Sell online courses and certifications for learning Voku, aimed at professionals in tech, legal, and research fields. Revenue comes from course fees and certification renewals.
Provide consulting to organizations integrating Voku into their AI workflows, including custom tool development and protocol design. This generates project-based or retainer fees.
💬 Integration Tip
Start by using the quick-start files and translator tool for basic tasks, then gradually incorporate advanced grammar and vocabulary as needed.
Translate text accurately — preserve formatting, handle plurals, and adapt tone per locale.
Thinking partner that transforms ideas into platform-optimized content
AI-agent Skill for PPTX OOXML localization workflows. Use it to unpack PPTX, extract and apply text translations, normalize terminology, enforce language-specific fonts, validate XML integrity, and repack outputs with machine-readable JSON interfaces for automation.
Get subtitles from YouTube videos for translation, language learning, or reading along. Use when the user asks for subtitles, subs, foreign language text, or wants to read video content. Supports multiple languages and timestamped output for sync'd reading.
Translate PowerPoint files to any language while preserving layout. Uses a render-and-verify agent loop (LibreOffice + Vision) to guarantee no text overflow....
Apply metadata updates to existing Calibre books via calibredb over a Content server. Use for controlled metadata edits after target IDs are confirmed by a read-only lookup.