Skip to content

Commit e8b1a08

Browse files
omriariavclaude
andcommitted
docs(gmail): Add search tips and common gotchas to SKILL.md
Learned from real usage session where email search was inefficient: - Document that `to:` only matches To header, not CC - Warn that `list` message_id is the latest in thread (may not be user's) - Add strategy for finding specific person's emails using thread view - Bump version to 1.1.0 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 5908ea2 commit e8b1a08

File tree

1 file changed

+4
-1
lines changed

1 file changed

+4
-1
lines changed

skills/gmail/SKILL.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: gws-gmail
3-
version: 1.0.0
3+
version: 1.1.0
44
description: "Google Gmail CLI operations via gws. Use when users need to list emails, read messages, send email, manage labels, archive, or trash messages. Triggers: gmail, email, inbox, send email, mail, labels, archive, trash."
55
metadata:
66
short-description: Google Gmail CLI operations
@@ -165,6 +165,9 @@ gws gmail list --format text # Human-readable text
165165

166166
## Tips for AI Agents
167167

168+
- `list` returns the latest `message_id` per thread — reading it may show someone else's reply. To find a specific person's message, use `gws gmail thread <thread-id>` and scan all messages
169+
- When searching for emails involving a person, use the bare email as a search term (`from:me user@domain.com`) rather than `to:user@domain.com` — the `to:` operator only matches the To header, not CC recipients
170+
- If using employee lookup tools to get someone's email, use the exact returned address — don't guess the format (e.g., `lior.g@` not `lior.golan@`)
168171
- Always use `--format json` (the default) for programmatic parsing
169172
- Use `gws gmail list` to get IDs: `message_id` for `read`/`label`/`archive`/`trash`, `thread_id` for `thread`
170173
- Use `gws gmail thread <thread-id>` to view full conversations with all messages

0 commit comments

Comments
 (0)