129 lines
3.6 KiB
Markdown
129 lines
3.6 KiB
Markdown
# Gmail Assistant Skill
|
|
|
|
A comprehensive skill for managing email workflows using the gmaillm CLI tool.
|
|
|
|
## Skill Structure
|
|
|
|
```
|
|
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
|
|
|
|
1. **Email Composition** - Draft emails with context from past messages
|
|
2. **Search & Discovery** - Find similar emails, threads, and patterns
|
|
3. **Contact Finding** - Search web for email addresses before sending
|
|
4. **Group Management** - Create and manage distribution lists
|
|
5. **Style Management** - Work with email style templates
|
|
6. **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:
|
|
1. Search for similar past emails
|
|
2. Review relevant threads
|
|
3. Check available styles
|
|
4. Draft based on context
|
|
5. TEST to fuchengwarrenzhu@gmail.com
|
|
6. Send after user confirms
|
|
|
|
### Find Contact and Send
|
|
|
|
Claude will:
|
|
1. Search web for contact information
|
|
2. Extract email address
|
|
3. Draft appropriate message
|
|
4. TEST first
|
|
5. 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:
|
|
|
|
```bash
|
|
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
|
|
|
|
## Related Files
|
|
|
|
- **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)
|