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:

1. Authenticate with Gmail API using credentials at $GMAIL_CREDENTIALS_PATH
2. Fetch recent emails (default: last 10 unread emails)
3. Summarize each email with:
4. Sender and subject
5. Key points from the email body
6. Recommended actions or responses
7. Present results in an organized, easy-to-scan format

Instructions for the Agent

When this skill is invoked:

1. First, verify that the Gmail API credentials exist at the path specified in $GMAIL_CREDENTIALS_PATH environment variable
2. Run the helper script located at {baseDir}/scripts/fetch_emails.py with the appropriate arguments:
3. Default: python3 {baseDir}/scripts/fetch_emails.py --count 10
4. With arguments: python3 {baseDir}/scripts/fetch_emails.py $ARGUMENTS
5. Parse the JSON output from the script
6. For each email, provide a concise summary including:
7. From: Sender name and email
8. Subject: Email subject line
9. Summary: 2-3 sentence summary of key points
10. Action: Suggested action (reply, archive, flag for follow-up, etc.)
11. 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)