Skip to content

benoror/obsidianos_work / .agents/skills/mail-transcripts

mail-transcripts

Verified

Gmail AI transcript notifications → meeting Notes: URLs + mark read. Args: (none). Invoked standalone or as step 1 of /meeting wrap.

FileKindSize
SETUP.mdmarkdown2.8 KB
SKILL.mdskill md4.0 KB
# Gmail transcript automation setup

Mode for **`/mail-transcripts`** and step 1 of **`/meeting wrap`**. Drains Gemini notification emails into meeting `Notes:` frontmatter via [`.scripts/gmail_ai_transcripts_to_meetings.py`](../../../.scripts/gmail_ai_transcripts_to_meetings.py).

## Prerequisites

1. **[Google Workspace CLI](https://github.com/googleworkspace/cli)** (`gws`) installed and authenticated.
2. **Gmail OAuth scopes** including **`gmail.modify`** (the script marks processed messages read).
3. **Python 3** on your `PATH` (`python3`).
4. Vault folder layout under `Meetings/` (see [README.md](../../../README.md) § Vault structure).

## Gmail label and filter

1. Create a label named exactly **`🤖-ai-transcripts`** (includes the robot emoji).
2. Create a filter that applies the label to Gemini messages, for example:
   - Subject contains `Notes by Gemini`
   - Or subject matches `Notes: "…"` pattern from Gemini meeting summaries
3. Keep filtered messages in **Inbox** — the script query is:

```text
label:🤖-ai-transcripts in:inbox
```

To change the query, edit `GMAIL_Q` in the Python script and update [mail-transcripts/SKILL.md](SKILL.md) § Gmail filter.

## Customize meeting routing

Edit `resolve_path()` in [`.scripts/gmail_ai_transcripts_to_meetings.py`](../../../.scripts/gmail_ai_transcripts_to_meetings.py). Default routes:

| Title pattern | Destination |
|---------------|-------------|
| Daily standup | `Meetings/Engineering/Scrum/YYYY-MM-DD.md` |
| Sprint planning / retro / grooming | `Meetings/Engineering/Scrum/…` |
| Tech / team leads weekly | `Meetings/Engineering/TechLeads/…` |
| Interview … | `Meetings/Interviews/…` |
| Everything else | `Meetings/_inbox/` → triage with **`/organize-meetings`** |

Also set `LOCAL_TZ` if you want `created:` timestamps in your local offset (default: UTC).

## Run

From the vault root:

```bash
python3 .scripts/gmail_ai_transcripts_to_meetings.py
```

Or invoke **`/mail-transcripts`** from your agent.

## After the script runs

- New notes land in routed folders or `_inbox/`.
- Run **`/organize-meetings`** to move `_inbox/` files to the correct subfolder.
- Run **`/meeting wrap pending`** or **`/cache-notes all`** to embed transcripts.

## Troubleshooting

| Symptom | Fix |
|---------|-----|
| `gws: command not found` | Install CLI; ensure it is on `PATH` |
| Auth / scope errors | Re-run `gws auth login` with Gmail modify scope |
| `Found 0 message(s)` | Check label name (emoji!), filter, and that messages stay in Inbox |
| Wrong meeting file | Adjust `resolve_path()` or move the note manually |
| Subject `skip` in summary | Subject didn't match `Notes: "Title" Mon DD, YYYY` — extend `parse_subject_date()` if needed |

See also [google-workspace-cli](../_shared/google-workspace-cli.md) for raw `gws gmail` commands.
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall