gmail-assistant/
├── SKILL.md                          # Main skill instructions
├── references/
│   └── quick-reference.md           # Concrete syntax examples and common patterns
└── assets/
    └── style-template.md            # Template for creating new email styles

What This Skill Provides

Core Workflows

Email Composition - Draft emails with context from past messages
Search & Discovery - Find similar emails, threads, and patterns
Contact Finding - Search web for email addresses before sending
Group Management - Create and manage distribution lists
Style Management - Work with email style templates
Workflow Automation - Set up and run email processing workflows

Progressive Disclosure Design

The skill follows gmaillm's progressive disclosure pattern:

SKILL.md provides high-level workflows and discovery patterns
quick-reference.md loaded when concrete syntax examples needed
style-template.md used when creating new email styles

Safety First

The skill emphasizes always testing first to fuchengwarrenzhu@gmail.com before sending real emails.

Usage Examples

Compose Email with Context

Claude will:

Search for similar past emails
Review relevant threads
Check available styles
Draft based on context
TEST to fuchengwarrenzhu@gmail.com
Send after user confirms

Find Contact and Send

Claude will:

Search web for contact information
Extract email address
Draft appropriate message
TEST first
Send after confirmation

Manage Distribution Groups

Claude can:

List existing groups
Create new groups
Add/remove members
Send to groups
Validate group emails

Key Features

Runtime Discovery

Instead of loading all documentation upfront, Claude uses discovery commands:

uv run gmail styles list        # See what's available
uv run gmail styles show posts  # Get specific details
uv run gmail styles examples    # Learn patterns

Context-Aware Email Drafting

Claude searches past emails to:

Match tone with previous interactions
Reference relevant context
Follow established patterns
Maintain consistency

Multi-Channel Search

Search email history (gmaillm)
Search web for contacts (WebSearch/WebFetch)
Combine information for informed communication

Testing

A test email was sent during skill creation to verify the workflow:

To: fuchengwarrenzhu@gmail.com
Subject: [TEST] Gmail Assistant Skill - Testing Email Workflow
Status: ✅ Delivered (Message ID: 19a5a8dd9f5e3a21)

Integration with gmaillm

This skill works with gmaillm CLI commands:

gmail send - Send emails (with TEST-first workflow)
gmail search - Find past emails
gmail read - Read messages and threads
gmail groups - Manage distribution lists
gmail styles - Work with email templates
gmail workflows - Automate email processing

All commands support --output-format json for programmatic parsing.

Skill Metadata

Name: gmail-assistant
Description: Email workflow management using gmaillm CLI
Location: ~/.claude/plugins/.../skills/gmail-assistant/
Created: 2025-11-06
Test Status: ✅ Verified working

SKILL.md - Main instructions (always loaded when skill triggers)
quick-reference.md - Syntax examples (loaded on demand)
style-template.md - Template for new styles (used when creating styles)

README.md

Gmail Assistant Skill

Skill Structure