# Report Generator

> Generates a structured report HTML based on a specific template. Invoke when user wants to create a report, slide, or summary card from raw content.

- Skill: `javimosch/report-generator` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/report-generator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/report-generator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: javimosch (https://skillmd.com/u/javimosch)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/javimosch/report-generator

---


# Report Generator Skill
 
 This skill generates a beautifully formatted HTML report based on a clean, minimal business template style (Light & Concise).

## Capabilities

1. **Refine Content**: Structures raw text into a 4-quadrant format (Goal, Q1-Q4 details, Summary).
2. **Generate HTML**: Creates a responsive HTML file.
3. **Screenshot**: (Instruction) Guides the agent to convert the HTML to an image using the browser tool.

## Usage

### 1. Prepare Data

You need to extract the following information from the user's input:

- **title**: Report Title
- **goal**: One-sentence goal (Top section)
- **q1** to **q4**: Four main sections, each containing:
  - `title`: Short title (e.g., "稳交付")
  - `subtitle`: Explanatory subtitle
  - `slogan`: Catchy slogan
  - `items`: List of bullet points (Array of strings)
- **summary**: Array of 4 keywords for the bottom summary

### 2. Run Generation Script

Execute the python script with the JSON data:

```bash
python3 scripts/generate.py --output "workspace/reports" --data '{"title": "...", ...}'
```

### 3. Convert to Image (Agent Action)

After the script returns the `html_path`, use the **browser** tool to screenshot it:

1. Open the file: `file://<html_path>`
2. Take a screenshot of the full page.

## Example Data Structure

```json
{
  "title": "2024 Q3 述职报告",
  "goal": "构建可规模化的非平台件能力体系",
  "q1": {
    "title": "稳交付",
    "subtitle": "解决扛量问题",
    "slogan": "保交付，争第一",
    "items": ["保障核心需求上线", "降低事故概率"]
  },
  "q2": { ... },
  "q3": { ... },
  "q4": { ... },
  "summary": ["稳定性", "增长", "效率", "反馈"]
}
```