# Reports

> Save and load timestamped reports as brain pages. Keyword routing for fast lookup. Scheduled jobs (systemd timers, agent schedulers) save output as reports; the agent or user queries them by keyword.

- Skill: `timurgaleev/reports` (Agent Skill)
- Install (CLI): `npx get-skill add timurgaleev/reports`
- Raw SKILL.md: https://api.skillmd.com/api/skills/timurgaleev/reports/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: timurgaleev (https://skillmd.com/u/timurgaleev)
- Updated: 2026-11-16
- Page: https://skillmd.com/skills/timurgaleev/reports

---


# Reports Skill

## Contract

This skill guarantees:
- Reports saved as brain pages with timestamped slugs and frontmatter
- Keyword routing: query → report category mapping
- Latest report loadable by category name
- Reports are searchable via the `search` and `query` tools

## Phases

1. **Save report.** `page_put` to `reports/{category}/{YYYY-MM-DD-HHMM}` with frontmatter:
   ```yaml
   ---
   title: {report title}
   type: report
   category: {category name}
   date: {YYYY-MM-DD}
   time: {HH:MM local}
   ---
   ```
2. **Load latest.** Given a category, `page_list` under `reports/{category}/` and
   `page_get` the most recent slug (timestamped slugs sort lexically).
3. **Keyword routing.** Map common queries to report categories:
   - "email" / "inbox" → ea-inbox-sweep
   - "social" / "mentions" → social-mentions
   - "briefing" / "morning" → morning-briefing
   - "meeting" → meeting-sync
   - Custom mappings configurable

## Output Format

Saved: `reports/{category}/{YYYY-MM-DD-HHMM}`
Loaded: full report content with metadata.

## Anti-Patterns

- Saving reports without frontmatter (makes them unsearchable)
- Using inconsistent category names across runs
- Loading all reports when only the latest is needed
- Not routing by keyword (forcing exact category name)

