sgolovine/report-kit

Report Kit is a lightweight framework for building clean, professional looking reports using only HTML and CSS. It is designed so that both people and AI agents can turn data, findings, and recommendations into a compact, readable report without writing JavaScript, without pulling in external fonts or remote assets, and without any build step. The default look is a high contrast, grayscale style that resembles a printed form. It is meant to be dense but easy to scan, and it works whether you open the report in a browser or print it to PDF. The project includes ready made components such as metric cards, charts, tables, callouts, timelines, and notes, all built with semantic HTML so they remain accessible, including proper headings, table captions, and text alternatives for charts. There is no package manager or installation step required. You can simply download the latest release or clone the repository, then copy the templates and stylesheet into your own project and replace the sample content with your own. Global CSS custom properties let you adjust the color palette, spacing, density, and page width. A notable feature is that Report Kit ships as two portable agent skills, called create-report and create-theme, which can be installed into tools like Codex, Claude Code, GitHub Copilot, ChatGPT, or Claude.com. Once installed, these skills let an AI agent generate and validate reports or new themes using the bundled templates and components. The project also provides a ready to use report template with a cover section, headline metrics, a comparison chart, and a decision focused takeaway, along with guidance to avoid inventing numbers: missing information should be marked as not available rather than shown as zero.