| name | email-summary |
| description | Fetches recent emails from Gmail and provides concise summaries. Use when the user wants to check emails, get email summaries, or review their inbox. |
| homepage | https://github.com/yourusername/email-summary-skill |
Email Summary Skill
This skill fetches recent emails from your Gmail account and provides AI-powered summaries.
How it works
When invoked, this skill will:
- Authenticate with Gmail API using credentials at
$GMAIL_CREDENTIALS_PATH
- Fetch recent emails (default: last 10 unread emails)
- Summarize each email with:
- Sender and subject
- Key points from the email body
- Recommended actions or responses
- Present results in an organized, easy-to-scan format
Instructions for the Agent
When this skill is invoked:
- First, verify that the Gmail API credentials exist at the path specified in
$GMAIL_CREDENTIALS_PATH environment variable
- Run the helper script located at
{baseDir}/scripts/fetch_emails.py with the appropriate arguments:
- Default:
python3 {baseDir}/scripts/fetch_emails.py --count 10
- With arguments:
python3 {baseDir}/scripts/fetch_emails.py $ARGUMENTS
- Parse the JSON output from the script
- For each email, provide a concise summary including:
- From: Sender name and email
- Subject: Email subject line
- Summary: 2-3 sentence summary of key points
- Action: Suggested action (reply, archive, flag for follow-up, etc.)
- Present all summaries in a well-formatted list
Usage Examples
/email-summary
Fetches and summarizes the last 10 unread emails.
/email-summary --count 20
Fetches and summarizes the last 20 unread emails.
/email-summary --all
Fetches and summarizes all unread emails.
Setup Requirements
Before using this skill, ensure:
- Gmail API credentials are configured
- Environment variable
GMAIL_CREDENTIALS_PATH points to your credentials JSON file
- Python 3 and required packages are installed (see setup guide in README.md)
