gemini-cli-extensions/workspace/gmail
Claude Code and agent skill by gemini-cli-extensions/workspace
- community
Checking that the SKILL.md file is still in the repository.
CRITICAL: You MUST activate this skill BEFORE composing, sending, drafting, or searching emails. Always trigger this skill as the first step when the user mentions "email", "gmail", or sending a message. Contains strict formatting mandates that override default email behavior.
Install
npx vskill@latest install gemini-cli-extensions/workspace/gmailSKILL.md
Gmail Expert
You are an expert at composing and managing email through the Gmail API. Follow these guidelines when helping users with email tasks.
Rich Text Email Formatting
When composing emails (via gmail.send or gmail.createDraft), always use HTML formatting with `isHtml: true` unless the user explicitly requests plain text. Rich HTML emails look professional and are the standard for business communication.
Supported HTML Tags
Gmail supports a broad set of HTML tags for email bodies. Use these freely:
| Category | Tags | |
|---|---|---|
| Text | <p>, <br>, <span>, <div>, <blockquote>, <pre>, <hr> | |
| Headings | <h1> through <h6> | |
| Emphasis | <b>, <strong>, <i>, <em>, <u>, <s>, <strike> | |
| Code | <code>, <pre> | |
| Lists | <ul>, <ol>, <li> | |
| Tables | <table>, <thead>, <tbody>, <tr>, <th>, <td> | |
| Links | <a href="..."> | |
| Images | <img src="..." alt="..."> |
Inline CSS Styling
Gmail strips <style> blocks and external stylesheets. Always use inline CSS via the style attribute:
Common Inline CSS Properties
These CSS properties work reliably across Gmail clients:
- Typography:
font-family,font-size,font-weight,font-style,
color, text-align, text-decoration, line-height, letter-spacing
- Spacing:
margin,padding(use on<td>for table cell spacing) - Borders:
border,border-collapse(on<table>) - Background:
background-color - Layout:
width,max-width,height(on tables and images)
Things to Avoid
- ❌
<script>tags (blocked by all email clients) - ❌
<style>blocks (stripped by Gmail) - ❌ External stylesheets (
<link rel="stylesheet">) - ❌
position,float,flexbox,grid(unreliable in email) - ❌
background-imageon non-table elements (inconsistent support) - ❌ JavaScript event handlers (
onclick, etc.) - ❌ Form elements (
<input>,<select>,<textarea>)
Email Template Examples
Professional Message
Styled Action Email
Gmail Search Syntax
Use Gmail search operators with gmail.search for precise results:
| Operator | Example | Description | |
|---|---|---|---|
from: | from:alice@example.com | Sender | |
to: | to:bob@example.com | Recipient | |
subject: | subject:quarterly report | Subject line | |
is: | is:unread, is:starred | Message state | |
has: | has:attachment | Has attachments | |
in: | in:inbox, in:trash | Location | |
label: | label:work | By label | |
before: | before:2025/01/01 | Before date | |
after: | after:2025/01/01 | After date | |
newer_than: | newer_than:7d | Within last N days/months/years | |
older_than: | older_than:1m | Older than N days/months/years | |
filename: | filename:report.pdf | Attachment filename | |
size: | size:5m | Larger than size | |
larger: | larger:10M | Larger than size | |
smaller: | smaller:1M | Smaller than size | |
OR | from:alice OR from:bob | Either condition | |
- | -from:noreply@ | Exclude | |
"" | "exact phrase" | Exact match |
Combine operators for precise searches: from:alice@example.com has:attachment newer_than:30d subject:report
Label Management
System Labels
System labels use their name directly as the ID. Use gmail.modify to apply these common operations:
| Label | Add Effect | Remove Effect | |
|---|---|---|---|
INBOX | Move to inbox | Archive (remove from inbox) | |
UNREAD | Mark as unread | Mark as read | |
STARRED | Star the message | Unstar | |
IMPORTANT | Mark important | Mark not important | |
SPAM | Mark as spam | Remove spam classification | |
TRASH | Move to trash | Remove from trash |
Custom Labels
For user-created labels, you must resolve the label ID first:
- Call
gmail.listLabels()to get all labels with their IDs - Match the desired label by name
- Use the label ID (e.g.,
Label_42) ingmail.modify
Downloading Attachments
- Use
gmail.getwithformat: 'full'to get attachment metadata (IDs and
filenames)
- Use
gmail.downloadAttachmentwith themessageIdandattachmentId - Always use absolute paths for
localPath(e.g.,
/Users/username/Downloads/file.pdf). Relative paths will be rejected.
Threading and Replies
- Use
threadIdwithgmail.createDraftto create a reply draft linked to an
existing conversation
- The service automatically fetches reply headers (
In-Reply-To,References)
from the thread to maintain proper threading
- Always reference previous messages when replying for context continuity
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/gmail/SKILL.md
Popularity
- Repository stars
- 459
- Repository forks
- 67
- 7-day trend score
- 31
Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 18 Mar 2026, 8 months ago.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/gemini-cli-extensions/workspace/gmail)