Reports Skill

Contract

This skill guarantees:

• Reports saved with timestamped filenames and frontmatter
• Keyword routing: query → report category mapping
• Latest report loadable by category name
• Reports are searchable via gbrain search/query
• Outbound reports pass the Actionability Gate (below) before delivery

Phases

1. Save report. Write to reports/{category}/{YYYY-MM-DD-HHMM}.md with frontmatter:

   ---
   title: {report title}
   type: note            # a type the default pack declares; `report` is undeclared
   report_type: {category name}
   category: {category name}
   date: {YYYY-MM-DD}
   time: {HH:MM PT}
   ---
   

2. Load latest. Given a category, find the most recent report file.
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}.md Loaded: full report content with metadata.

Actionability Gate

Before any report reaches the user, a morning briefing, a meeting digest, a research report, every link must answer one question: can the user click this and immediately act? The link canon (deterministic, never-guessed URLs) lives in skills/_output-rules.md under Deterministic Links; this gate adds the delivery-time failure taxonomy and the retry loop.

Four failure modes