# Report
> Generate self-contained HTML reports instead of long terminal output. For task completions, research, audits, comparisons, and blockers.
- Skill: `marcindudekdev/report` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add marcindudekdev/report`
- Raw SKILL.md: https://api.skillmd.com/api/skills/marcindudekdev/report/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: MarcinDudekDev (https://skillmd.com/u/marcindudekdev)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/marcindudekdev/report
---
# HTML Report Generation
## When to Use
- Task completions with file changes
- Research results and analysis
- Audits and quality checks
- Error/blocker reports requiring user action
- Comparisons (tools, approaches, options)
- Any output exceeding ~10 lines
## When NOT to Use
- Short answers, yes/no, status updates
- Quick confirmations (<10 lines)
## Report Types
### task-completion
Sections: Summary, Changes Made (files list), Verification Results, Next Steps
### research
Sections: Key Findings, Detailed Analysis, Recommendations, Sources
### audit
Sections: Overall Score/Grade, Pass/Fail Table, Detailed Findings, Recommendations
### error-blocker
Sections: What's Blocked, Root Cause Analysis, What User Needs To Do, Workarounds
### comparison
Sections: Options Overview Table (with pros/cons), Detailed Analysis, Recommendation
## Workflow
1. Generate HTML content using the template below
2. Get project name:
```bash
tmux display-message -p '#S' 2>/dev/null || basename "$PWD"
```
3. Get target path:
```bash
report --path --project "{name}" --title "{title}" --type {type}
```
4. Write the HTML file to that path
5. Open it:
```bash
report --open "{filepath}"
```
6. Print ONE line to terminal: `Report: {title} -> {filepath}`
## HTML Template
```html
REPORT_TITLE
```
## Content Patterns
### Pass/Fail Row (for audit tables)
```html
Check Name
✓ Pass Details about what was checked
```
### File Change Row (for task-completion)
```html
path/to/file.pyModified
Brief description of change
```
### Comparison Cell
```html
Option Name + Pro point - Con point
```
## Images in Reports
- **NEVER embed base64-encoded images** in report HTML
- When including screenshots or images:
1. Save the image file in the same directory as the report HTML
2. Reference with relative path: ` 
`
- Image filenames should be descriptive: `homepage-hero.webp`, `error-state.webp`, etc.
## Important
- Reports are SELF-CONTAINED — all CSS is inline or from CDN
- Always include the `