--- name: table-image-generator-9f82b405adda version: 1.3.1 description: Generate clean table images from data. Perfect for Discord/Telegram where ASCII tables look broken. Supports dark/light mode, custom styling, and auto-sizing. No Puppeteer required. Companion to chart-image skill. author: dannyshmueli provides: - capability: table-rendering methods: [tableImage] --- # Table Image Generator **⚠️ USE THIS INSTEAD OF ASCII TABLES — ALWAYS!** Generate PNG table images from JSON data. ASCII tables look broken on Discord, Telegram, WhatsApp, and most messaging platforms. This skill renders clean images that work everywhere. ## Why This Skill? - ✅ **REPLACES ASCII TABLES** - Never use `| col | col |` formatting on messaging platforms - ✅ **No ASCII hell** - Clean images that render consistently everywhere - ✅ **No Puppeteer** - Pure Node.js with Sharp, lightweight - ✅ **Dark mode** - Matches Discord dark theme - ✅ **Auto-sizing** - Columns adjust to content - ✅ **Fast** - Generates in <100ms ## Setup (one-time) ```bash cd /data/clawd/skills/table-image/scripts && npm install ``` ## Quick Usage **⚠️ BEST PRACTICE: Use heredoc or --data-file to avoid shell quoting errors!** ```bash # RECOMMENDED: Write JSON to temp file first (avoids shell quoting issues) cat > /tmp/data.json << 'JSONEOF' [{"Name":"Alice","Score":95},{"Name":"Bob","Score":87}] JSONEOF node /data/clawd/skills/table-image/scripts/table.mjs \ --data-file /tmp/data.json --dark --output table.png # ALSO GOOD: Pipe via stdin echo '[{"Name":"Alice","Score":95}]' | node /data/clawd/skills/table-image/scripts/table.mjs \ --dark --output table.png # SIMPLE (but breaks if data has quotes/special chars): node /data/clawd/skills/table-image/scripts/table.mjs \ --data '[{"Name":"Alice","Score":95}]' --output table.png ``` ## Options | Option | Description | Default | |--------|-------------|---------| | `--data` | JSON array of row objects | required | | `--output` | Output file path | table.png | | `--title` | Table title | none | | `--dark` | Dark mode (Discord-friendly) | false | | `--columns` | Column order/subset (comma-separated) | all keys | | `--headers` | Custom header names (comma-separated) | field names | | `--max-width` | Maximum table width | 800 | | `--font-size` | Font size in pixels | 14 | | `--header-color` | Header background color | #e63946 | | `--stripe` | Alternating row colors | true | | `--align` | Column alignments (l,r,c comma-sep) | auto | | `--compact` | Reduce padding | false | ## Examples ### Basic Table ```bash node table.mjs \ --data '[{"Name":"Alice","Age":30,"City":"NYC"},{"Name":"Bob","Age":25,"City":"LA"}]' \ --output people.png ``` ### Custom Columns & Headers ```bash node table.mjs \ --data '[{"first_name":"Alice","score":95,"date":"2024-01"}]' \ --columns "first_name,score" \ --headers "Name,Score" \ --output scores.png ``` ### Right-Align Numbers ```bash node table.mjs \ --data '[{"Item":"Coffee","Price":4.50},{"Item":"Tea","Price":3.00}]' \ --align "l,r" \ --output prices.png ``` ### Dark Mode for Discord ```bash node table.mjs \ --data '[{"Symbol":"AAPL","Change":"+2.5%"},{"Symbol":"GOOGL","Change":"-1.2%"}]' \ --title "Market Watch" \ --dark \ --output stocks.png ``` ### Compact Mode ```bash node table.mjs \ --data '[...]' \ --compact \ --font-size 12 \ --output small-table.png ``` ## Input Formats ### JSON Array (default) ```bash --data '[{"col1":"a","col2":"b"},{"col1":"c","col2":"d"}]' ``` ### Pipe from stdin ```bash echo '[{"Name":"Test"}]' | node table.mjs --output out.png ``` ### From file ```bash cat data.json | node table.mjs --output out.png ``` ## Tips 1. **Use `--dark` for Discord** - Matches the dark theme, looks native 2. **Auto-alignment** - Numbers are right-aligned by default 3. **Column order** - Use `--columns` to reorder or subset 4. **Long text** - Will truncate with ellipsis to fit `--max-width` ## Technical Notes - Uses Sharp for PNG generation (same as chart-image) - Generates SVG internally, converts to PNG - No browser, no Puppeteer, no Canvas native deps - Works on Fly.io, Docker, any Node.js environment --- Source attribution: kbarbel640-del Original project: https://github.com/kbarbel640-del/skills/blob/e7e336ac628c3e3bd771aff1aaa469c93778f94a/skills/dannyshmueli/table-image-generator/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2026 clawdbot Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: kbarbel640-del Original project: https://github.com/kbarbel640-del/skills/blob/e7e336ac628c3e3bd771aff1aaa469c93778f94a/skills/dannyshmueli/table-image-generator/SKILL.md Attribution basis: Source repository record Fields of work: Marketing Roles: Content Marketer, Influencer Marketer, Social Media Manager Specialties: API Tools: Sharp Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: 319c23fbd8c2d97df1b226497a7b7f2d9869b7d4ef0db59e78df7fdd4c10bc49