{
  "markdown": "<p align=\"center\">\n  <img src=\"https://raw.githubusercontent.com/GabrielBarberini/laconic/main/laconic.png\" width=\"120\" />\n</p>\n\n<h1 align=\"center\">laconic</h1>\n\n<p align=\"center\">\n  <strong>Philip II: \"If I invade Laconia, I shall turn you out.\"<br/>Sparta: \"If.\"</strong>\n</p>\n\n<p align=\"center\">\n  <a href=\"https://github.com/GabrielBarberini/laconic/stargazers\"><img src=\"https://img.shields.io/github/stars/GabrielBarberini/laconic?style=flat&color=yellow\" alt=\"Stars\"></a>\n  <a href=\"https://github.com/GabrielBarberini/laconic/commits/main\"><img src=\"https://img.shields.io/github/last-commit/GabrielBarberini/laconic?style=flat\" alt=\"Last Commit\"></a>\n  <a href=\"LICENSE\"><img src=\"https://img.shields.io/github/license/GabrielBarberini/laconic?style=flat\" alt=\"License\"></a>\n  <a href=\"https://gabrielbarberini.github.io/laconic/\"><img src=\"https://img.shields.io/badge/web-gabrielbarberini.github.io%2Flaconic-blue?style=flat\" alt=\"Website\"></a>\n</p>\n\n<p align=\"center\">\n  <a href=\"#install\">Install</a> &bull;\n  <a href=\"#benchmarks\">Benchmarks</a> &bull;\n  <a href=\"#examples\">Examples</a> &bull;\n  <a href=\"#caveman-vs-laconic\">Caveman vs Laconic</a>\n</p>\n\n---\n\n**laconic** is a 300 word skill for AI coding agents inspired by [caveman](https://github.com/JuliusBrussee/caveman). \n\nIt cuts filler.\nIt keeps meaning.\nIt trusts context.\n\nEvery word earns its place. \n\n## Benchmarks\n\n### Caveman Benchmark\nClaude Sonnet 4 via Langdock API. Each prompt: generic system prompt vs full laconic SKILL.md. Median of 3 runs per mode.\n\n<!-- BENCHMARK-TABLE-START -->\n| Task | Normal (tokens) | Laconic (tokens) | Saved | vs Caveman |\n|------|---------------:|----------------:|------:|-----------:|\n| Explain React re-render bug | 885 | 68 | 92% | +5pp |\n| Fix auth middleware token expiry | 1059 | 39 | 96% | +13pp |\n| Set up PostgreSQL connection pool | 2167 | 189 | 91% | +7pp |\n| Explain git rebase vs merge | 996 | 95 | 90% | +32pp |\n| Refactor callback to async/await | 494 | 62 | 87% | +65pp |\n| Architecture: microservices vs monolith | 826 | 209 | 75% | +45pp |\n| Review PR for security issues | 940 | 126 | 87% | +46pp |\n| Docker multi-stage build | 2635 | 149 | 94% | +22pp |\n| Debug PostgreSQL race condition | 1370 | 49 | 96% | +15pp |\n| Implement React error boundary | 4096 | 400 | 90% | +3pp |\n| **Average** | **1547** | **139** | **90%** | **+25pp** |\n\n*Range: 75%–96% savings across prompts. [Caveman benchmarks](https://github.com/JuliusBrussee/caveman#benchmarks) averaged 64%.*\n<!-- BENCHMARK-TABLE-END -->\n\n> [!IMPORTANT]\n> Laconic cuts output tokens only.\n\n<details>\n<summary>Run benchmarks yourself</summary>\n\n```bash\ncd benchmarks\npip install -r requirements.txt\n\necho \"LANGDOCK_API_KEY=sk-your-key\" > ../.env.local\n\npython run.py --dry-run\npython run.py\npython run.py --update-readme\n```\n\n</details>\n\n## Examples\n\n**Prompt**: *\"My Express auth middleware is letting expired JWT tokens through. The expiry check uses `Date.now()` compared to the token's `exp` field. What's wrong and how do I fix it?\"*\n\n<table>\n<tr>\n<td width=\"50%\">\n\n### 🗣️ Normal (~1,300 tokens)\n\nExplains JWT spec, Unix timestamps vs JavaScript milliseconds, walks through middleware architecture, adds error handling, suggests libraries, and outputs a full refactored file (...)\n\n</td>\n<td width=\"50%\">\n\n### Λ Laconic (19 tokens)\n\n> `exp` is in seconds. `Date.now()` is milliseconds.\n>\n> ```js\n> if (Date.now() / 1000 > payload.exp) // expired\n> ```\n\n</td>\n</tr>\n</table>\n\n## Caveman vs Laconic\n\n| | Caveman | Laconic |\n|--|---------|---------|\n| Tone | Primitive | Terse |\n| Explanation | Normal | Trusts context, skips what reader knows |\n| Code | Normal | Just enough code |\n| Token savings | ~65% | ~90% |\n\n## Install\n\n### Any agent (40+ supported)\n\n```bash\nnpx skills add GabrielBarberini/laconic\n```\n\n`npx skills` supports Claude Code, GitHub Copilot, Cursor, Windsurf, Cline, and [40+ more](https://github.com/vercel-labs/skills). To install for a specific agent:\n\n```bash\nnpx skills add GabrielBarberini/laconic -a cursor\nnpx skills add GabrielBarberini/laconic -a copilot\nnpx skills add GabrielBarberini/laconic -a cline\nnpx skills add GabrielBarberini/laconic -a windsurf\n```\n\n### Pi\n\n```bash\npi install https://github.com/GabrielBarberini/laconic\n```\n\nOr from npm:\n\n```bash\npi install npm:tau-laconic\n```\n\nOn pi you also get an extension: `/laconic [on|off]` (full laconic or off), natural-language triggers (\"be laconic\", \"normal mode\"), a `laconic` statusline, and per-project state in `.pi/laconic-mode.json`. It reads its rules from the same `SKILL.md`.\n\n### Claude Code (plugin)\n\n```bash\nclaude plugin marketplace add GabrielBarberini/laconic\nclaude plugin install laconic@laconic\n```\n\n### Codex\n\n1. Clone repo\n2. Open Codex in repo\n3. Run `/plugins`\n4. Search `Laconic`\n5. Install plugin\n\nOr copy the `plugins/laconic/` directory into your Codex plugins folder.\n\n## Usage\n\nTrigger with:\n- `/laconic`\n- \"laconic mode\"\n- \"be laconic\"\n\n## License\n\nMIT — Sparta needed no walls. Neither does this license.\n",
  "bytes": 5019,
  "sha": "ec045aaf5ded0a93a2571a83b25014f0f099d8f6ec018ebacbbed954227b0a17",
  "repo_slug": "gabrielbarberini/laconic",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_gabrielbarberini_laconic_laconic_24f4b832/readme"
}