{"id":"bde3325d-3e04-4302-8f69-74f5fbeebca2","slug":"vaib","kind":"skill","name":"vaib","summary":"Assembly for LLM Agents. High-density notation for flow-state vibe coding.","owner":"Chalarangelo","repoUrl":"https://github.com/Chalarangelo/vaib","license":"MIT","licenseTier":"permissive","trust":"community","stars":3,"match":null,"fewStars":true,"format":"skill","createdAt":"2026-10-02T07:00:31.000Z","addedAt":"2026-10-14T06:01:09.367Z","logoUrl":"https://avatars.githubusercontent.com/u/8281875?u=dc89af57b6d382af21ae3ebcaafc61621eeee096&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["developer-tools"],"tags":["ai","anthropic","claude","claude-code","llm","prompt-engineering","tokens"],"runtime":"binary","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-17T09:08:47.520Z","sample":false,"url":"https://conduits.dev/tools/vaib","language":"Python","transports":["stdio"],"install":{},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# 🌊 vaib\n\n**Assembly for LLM Agents.** High-density DSL to save tokens and flow.\n\n---\n\n## ⚡ Why vaib?\nTraditional LLM prompts waste tokens on conversational filler, imprecise descriptions, and redundant file rewrites. **vaib** is an open-source, zero-compilation linguistic wrapper and cognitive-steering protocol built for agentic terminals (`claude-code`, Cursor, VS Code Agents).\n\n* **The 3 Zeroes**: **Zero Fluff** (up to 85% token reduction via `caveman` mode), **Zero Redo Tax** (guard clauses eliminate hallucinated logic bugs), **Zero Setup** (runs natively in your agent context).\n* **Prefix-Cache Optimized**: Declarative frontmatter triggers 100% LLM cache hits.\n* **Single-Line Friendly**: Type rapid multi-step logic on a single line using inline `;` chaining without messy multiline chat boxes.\n* **Diff-Only Output**: `terse_diff` saves 65%–75% output costs by emitting raw line mutations instead of full-file rewrites.\n\n---\n\n## 🚀 60-Second Quickstart\nInject the core linguistic engine directly into your global agent profile:\n\n```bash\ncurl -sSL [https://raw.githubusercontent.com/Chalarangelo/vaib/main/install.sh](https://raw.githubusercontent.com/Chalarangelo/vaib/main/install.sh) | bash\n```\n\nFire up your agentic CLI terminal, type `/skills` (or verify `~/.claude/skills/vaib`), and `vaib` becomes an active protocol layer.\n\n---\n\n## 📉 Token Overclocking & Performance Metrics\n\nBecause `vaib` structures your inputs into high-density declarative data maps and skips conversational AI fluff, it leverages modern LLM **prefix-caching** to its absolute limits:\n\n*   **`output_format: terse_diff`** – Slashes output costs by **65%–75%** by forcing the agent to output raw structural Git line mutations instead of rewriting full files.\n*   **`output_format: caveman`** – Achieves a brutal **85% text compression rate**. The AI strips out verbs, pronouns, and polite greetings—speaking in pure, token-lean engineering fragments while maintaining 100% byte-exact code precision.\n\n---\n\n## 💎 Semantic Toolkit\nStop writing paragraphs. Steer your agent with precise structural operators:\n\n### 🚦 Flow & Logic Control\n* `;` — **Inline Chain.** Express multi-statement workflows on a single line.\n* `unless cond` — **Postfix Guard.** Early-exit guard clause (`throw: Err unless user.active?`).\n* `given: [a, b]` — **Preconditions.** Logical assertion array before execution.\n* `:symbol` — **Enum Keys.** Concise status mapping (`:pending`, `:approved`).\n* `method?` — **Inspection Suffix.** Side-effect-free boolean checks.\n* `action!` — **Enforcement Suffix.** Hard database commits or runtime exception throws.\n* `{{ loose thoughts }}` — **Natural Escape.** Drop raw, unstructured thoughts mid-syntax.\n* `\"literal\"` / `'char'` — **Text Lock.** Guarantees exact UI string or character preservation.\n\n### 🎭 Cognitive Identity & Context Controls\n* `&scope(\"path\")` — **Context Guard.** Restricts agent focus strictly to specified path(s).\n* `&dry` — **Plan Lockdown.** Forces a 3-line structural dry run before touching files.\n* `&grill` — Shifts agent into a hostile Principal Engineer hunting defects and security leaks.\n* `&architect` — Systems optimization mode. Forces schema trees and service boundaries first.\n* `&mentor` — Deep educational mode with pattern breakdowns and metaphors.\n\n---\n\n## ⚡ vaib in Action (Showcase & Examples)\n\nSee how `vaib` strips away the conversational noise and boilerplate, turning you into a high-leverage intent designer.\n\n### 1. The Secure Payment Loop (Backend & Logic Architecture)\nInstead of typing out a wall of text detailing database safety, retry limits, and errors, express your transaction layer in just a few structured lines.\n\n```yaml\n---\nvaib: Payments/Capture/v2\nstack: [TypeScript, Prisma, Stripe]\noutput_format: terse_diff\n---\n\n# State: Wallet\n- balance: decimal! [invariant: >= 0]\n- status: enum(:active, :frozen, :flagged)\n\n# Logic\n- fn ProcessTransfer(from_id, to_id, amount) {\n    from = Wallet.find(from_id) ; to = Wallet.find(to_id)\n    \n    # Postfix guards & enum symbols eliminate multi-line nested IFs\n    throw: InsufficientFunds unless from.balance >= amount\n    throw: FrozenAccount if from.status == :frozen || to.status == :frozen\n    \n    # Destructive action with backoff retry and fallback\n    Stripe.charge!(from.customer_id, amount) [retry: 3]\n    rescue: -> &ask(\"Gateway timed out. Fallback to local ledger?\")\n    \n    from.balance -= amount ; to.balance += amount\n    -> mutate: Wallet.save_all!([from, to])\n}\n```\n\n### 2. The Dynamic UI Component (Text & State Preservation)\nWhen building layouts, stop the AI from guessing your exact interface copy. Enforce strict character literals (`'X'`) and string locks (`\"Text\"`) to map Tailwind arrays cleanly.\n\n```yaml\n---\nvaib: Views/Dashboard/Alert\nstack: [React, TailwindCSS]\noutput_format: terse_diff\n---\n\n# State: Banner\n- variant: enum(info, warning, danger)\n- active_tab: char [default: 'A']\n\n# Logic\n- fn RenderAlert() {\n    match(variant):\n      \"danger\" => \n        Text.label = \"🚨 CRITICAL FAULT: Action Required Immediately!\"\n        Container.style = \"bg-red-500 border-l-4 border-red-700\"\n      \"warning\" => \n        Text.label = \"Warning: Check system status metrics.\"\n        Container.style = \"bg-amber-400\"\n        \n    Button.on_click -> \n        &trace -> {{ Dispatch telemetry, close banner, switch active_tab to 'B' }}\n}\n```\n\n### 3. High-Leverage Non-Technical Steering (Ops & Automation)\n`vaib` isn't just for writing raw code files. You can command your terminal agent to orchestrate deep diagnostics, handle telemetry issues, and translate the data for the rest of your company seamlessly.\n\n```yaml\n---\nvaib: Ops/IncidentTriage/v1\noutput_format: eli5\n---\n\n- Action:\n    # Directly calls system logs and attaches tracking history\n    tail(\"-n 100\", \"/var/log/nginx/error.log\")\n    &investigate(\"src/middleware/auth.ts\")\n    \n    # Tell the agent to switch into a Principal Engineer mindset, audit its own finding,\n    # and explain the fix like the reader is 5 years old.\n    then:\n      &grill -> &canary\n      => &explain(to: \"eli5\")\n```\n\n---\n\n## 🤝 Upstream Rule Synchronization\n\nPersist custom shortcuts locally or share them upstream without leaving your agent terminal:\n\n```yaml\n&memorize(\"Data/UltraCaching\") -> &submit(\"Core/Syntax\")\n```\n\nThe engine distills execution history, builds a clean syntax snippet, stages a branch, and opens an upstream GitHub PR.\n\n---\n\n**Stop coding. Start vibing.** 🌊\n"}