email

Aggregate Gmail and iCloud inbox metadata for AI-driven triage.

97|17|Updated Dec 29, 2025
One-click install
npx skills add https://github.com/antoniolg/agent-kit --skill email-antoniolg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: email
Source: https://github.com/antoniolg/agent-kit/tree/main/skills/email
Command: npx skills add https://github.com/antoniolg/agent-kit --skill email-antoniolg

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

List Gmail/iCloud inboxes showing a clean user view while preserving metadata (IDs) for later actions.

Core Features & Use Cases

  • Unified discovery of inbox items across Gmail and iCloud accounts with a clean, user-friendly listing.
  • Preserves and surfaces metadata (IDs) to enable later actions like open, archive or reply without losing state.
  • Supports end-to-end triage workflows via helpers in the skill (scripts/email-inbox, scripts/email-open, scripts/email-archive) and account configuration in ~/.config/skills/config.json under email.

Quick Start

Run scripts/email-inbox to fetch the current inbox state after configuring accounts in ~/.config/skills/config.json under email.

Frequently Asked Questions about email

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I aggregate Gmail and iCloud inboxes for unified triage?

To aggregate Gmail and iCloud inboxes for unified triage, the script lists inbox items across accounts while preserving message IDs. It surfaces a clean view and enables actions like opening or archiving emails without losing state for later automation.

How do I configure email accounts to use this inbox automation?

To configure email accounts for inbox automation, define your Gmail and iCloud credentials in the config.json file located at ~/.config/skills/config.json under the email key. This setup allows the scripts to authenticate and fetch current email states.

Can I archive or open emails across Gmail and iCloud without losing message IDs?

Yes, you can open or archive emails across Gmail and iCloud without losing message IDs. The skill uses helper scripts to execute these actions while preserving the underlying metadata, ensuring later automation workflows maintain accurate state references.

Does this email triage approach support cross-account automation workflows?

Yes, this email triage approach supports cross-account automation workflows by design. It aggregates Gmail and iCloud metadata and uses scripts for inbox discovery, opening, and archiving, explicitly preserving email IDs to enable subsequent automated actions.

What is the best way to fetch the current state of multiple email inboxes?

The best way to fetch the current state of multiple email inboxes is to run the email-inbox script. After configuring your Gmail and iCloud accounts in the config.json file, this script aggregates and surfaces a unified, clean listing of inbox items.