Gbrain reports
install
source · Clone the upstream repo
git clone https://github.com/garrytan/gbrain
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/garrytan/gbrain "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/reports" ~/.claude/skills/garrytan-gbrain-reports && rm -rf "$T"
manifest:
skills/reports/SKILL.mdsource content
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
Phases
- Save report. Write to
with frontmatter:reports/{category}/{YYYY-MM-DD-HHMM}.md--- title: {report title} type: report category: {category name} date: {YYYY-MM-DD} time: {HH:MM PT} --- - Load latest. Given a category, find the most recent report file.
- 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.
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)