json-render-table_skill

Overview

This skill renders compact, generic data tables into PNG screenshots using the json-render-cli components. It produces stable, edge-to-edge table images suitable for embedding in messages or reports, with configurable layout, theming, and output controls. Use it whenever you need clean visualizations of arbitrary rows/columns (non-ticket-specific).

How this skill works

The skill builds an in-memory JSON message from a compact table template, configures columns and rows, and invokes json-render-cli to create a PNG. It passes configuration via process substitution to avoid temp files, tunes viewport and screenshot options (including fullPage when needed), and returns an output path or Base64 when explicitly requested. Rendering can be run in the main agent or delegated to a sub-agent when handoff is explicit and deterministic.

When to use it

• Visualizing arbitrary structured rows/columns for screenshots or reports
• Generating compact, shareable table images for documentation or messaging
• Creating deterministic table snapshots where column widths and layout must be stable
• When you need PNG output instead of HTML/CSV exports
• Producing quick visual summaries without ticket-specific fields

Best practices

• Define explicit columns and widths before rendering to avoid wrapping and overflow
• Start with a compact viewport and only expand height when clipping appears
• Set screenshot.fullPage=true when row count or wrapping is variable
• Prefer -o /tmp/<name>.png for delivery; use stdout/Base64 only when requested
• Use Badges only for categorical status-like fields to preserve compactness
• Tune the widest column first when content overflows and avoid large horizontal slack

Example use cases

• Render a compact inventory table snapshot for a chat response
• Create a compact CSV-like dataset preview as a PNG attachment
• Produce a KPI comparison table image to include in a report
• Screenshot a tabular export of search results for archival or review
• Generate a deterministic table image for inclusion in a knowledge base