gh-cskiro-claudex/skills/benchmarking/report-creator/SKILL.md

name, description, version, author, category

name	description	version	author	category
report-creator	Use PROACTIVELY when user needs to create research reports, experiment writeups, technical whitepapers, or empirical studies. Provides templates with professional structure, CSS styling for PDF export, and proper figure/table formatting. Currently supports: Academic Research Report. Based on publication-quality standards.	0.1.0	Connor Skiro	documentation

Report Creator

Overview

Provides templates for creating publication-quality research reports with professional structure, styling, and PDF export optimization.

Available Templates:

• Academic Research Report: Full empirical study format

Key Capabilities:

• Academic structure (Abstract, Methodology, Results, Discussion)
• Professional tables with academic borders
• Figure support with captions and page-break protection
• PDF-optimized CSS via pandoc + weasyprint

When to Use

Trigger Phrases:

• "create a research report"
• "write up my experiment results"
• "technical whitepaper template"
• "empirical study format"

Use Cases:

• AI/ML experiment reports
• Benchmark evaluation writeups
• Technical research documentation
• Empirical study publications

NOT for:

• Blog posts or casual documentation
• API documentation
• Presentation slides
• Quick README files

Document Structure

Section	Content
Abstract	150-250 word summary
Executive Summary	Key finding + metrics table
1. Background	Research context, hypotheses
2. Methodology	Design, variables, protocol
3. Results	Statistics, observations
4. Discussion	Hypothesis evaluation, implications
5. Limitations	Methodological, dataset, evaluation
6. Future Work	Research directions
7. Conclusion	Synthesis, bottom line
Appendices	Supporting materials

Quick Start

1. Copy template from reference/report-template.md
2. Fill in sections with your research data
3. Add figures using HTML figure tags
4. Export to PDF:

# One-liner conversion
pandoc report.md --standalone --css=pdf-style.css -t html | weasyprint - report.pdf

Reference Files

File	Content
report-template.md	Full markdown template
pdf-style.css	Academic CSS styling
table-patterns.md	Table and figure patterns

Key Formatting Patterns

Tables (Academic Style)

• 2px borders on header top/bottom
• 1px borders between rows
• 2px border on final row
• page-break-inside: avoid

Figures

<figure style="margin: 2em auto; page-break-inside: avoid; text-align: center;">
  <img src="figure-1.png" alt="Description" style="max-width: 100%;">
  <figcaption>Figure 1: Caption text.</figcaption>
</figure>

Typography

Element	Usage
Bold	Key findings, hypothesis status
Italic	Figure captions, emphasis
code	Model IDs, file names
> Quote	Sample prompts, messages

Conversion Commands

# Prerequisites
which pandoc weasyprint  # Both required

# Two-step
pandoc report.md -o report.html --standalone --css=pdf-style.css
weasyprint report.html report.pdf

# One-liner
pandoc report.md --standalone --css=pdf-style.css -t html | weasyprint - report.pdf

Completion Checklist

• All 7 main sections present
• Abstract summarizes question, method, findings
• Executive summary has metrics table
• Tables have academic borders
• Figures have numbered captions
• No orphaned headings at page bottoms

Related Skills

• html-diagram-creator: Create figures for embedding
• html-to-png-converter: Export diagrams to PNG
• markdown-to-pdf-converter: General markdown conversion

---

Based on: paralleLLM empathy-experiment-v1.0.pdf (17 pages, November 2024)