Career-Ops Gmail Lead Plugin
career-ops-hq/career-ops
Pulls job leads from a Gmail label into the career-ops pipeline, extracting job URLs from DMARC-passing emails and de-duplicating against existing leads.
Read, send, draft, delete, and organize Gmail emails. An agent skill from aws-samples/sample-strands-agent-with-agentcore.
Install Gmail
$ npx skills add aws-samples/sample-strands-agent-with-agentcore --skill gmail -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install aws-samples/sample-strands-agent-with-agentcore gmail --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/aws-samples/sample-strands-agent-with-agentcore.git skills-src && mkdir -p .claude/skills && cp -r skills-src/chatbot-app/agentcore/skills/gmail .claude/skills/gmail && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "gmail" agent skill from https://github.com/aws-samples/sample-strands-agent-with-agentcore/tree/main/chatbot-app/agentcore/skills/gmail into .claude/skills/gmail/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gmail", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/aws-samples/sample-strands-agent-with-agentcore/tree/main/chatbot-app/agentcore/skills/gmailType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add aws-samples/sample-strands-agent-with-agentcore --skill gmail -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install aws-samples/sample-strands-agent-with-agentcore gmail --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/aws-samples/sample-strands-agent-with-agentcore.git skills-src && mkdir -p .agents/skills && cp -r skills-src/chatbot-app/agentcore/skills/gmail .agents/skills/gmail && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "gmail" agent skill from https://github.com/aws-samples/sample-strands-agent-with-agentcore/tree/main/chatbot-app/agentcore/skills/gmail into .agents/skills/gmail/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gmail", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add aws-samples/sample-strands-agent-with-agentcore --skill gmail -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install aws-samples/sample-strands-agent-with-agentcore gmail --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/aws-samples/sample-strands-agent-with-agentcore.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/chatbot-app/agentcore/skills/gmail .cursor/skills/gmail && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "gmail" agent skill from https://github.com/aws-samples/sample-strands-agent-with-agentcore/tree/main/chatbot-app/agentcore/skills/gmail into .cursor/skills/gmail/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gmail", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/aws-samples/sample-strands-agent-with-agentcore.git --path chatbot-app/agentcore/skills/gmail--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add aws-samples/sample-strands-agent-with-agentcore --skill gmail -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install aws-samples/sample-strands-agent-with-agentcore gmail --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/aws-samples/sample-strands-agent-with-agentcore.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/chatbot-app/agentcore/skills/gmail .gemini/skills/gmail && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "gmail" agent skill from https://github.com/aws-samples/sample-strands-agent-with-agentcore/tree/main/chatbot-app/agentcore/skills/gmail into .gemini/skills/gmail/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gmail", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install aws-samples/sample-strands-agent-with-agentcore gmailInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add aws-samples/sample-strands-agent-with-agentcore --skill gmail -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/aws-samples/sample-strands-agent-with-agentcore.git skills-src && mkdir -p .github/skills && cp -r skills-src/chatbot-app/agentcore/skills/gmail .github/skills/gmail && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "gmail" agent skill from https://github.com/aws-samples/sample-strands-agent-with-agentcore/tree/main/chatbot-app/agentcore/skills/gmail into .github/skills/gmail/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gmail", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add aws-samples/sample-strands-agent-with-agentcore --skill gmail -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install aws-samples/sample-strands-agent-with-agentcore gmail --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/aws-samples/sample-strands-agent-with-agentcore.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/chatbot-app/agentcore/skills/gmail .opencode/skills/gmail && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "gmail" agent skill from https://github.com/aws-samples/sample-strands-agent-with-agentcore/tree/main/chatbot-app/agentcore/skills/gmail into .opencode/skills/gmail/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gmail", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
gmail- GitHub stars
- 194
- Token cost
- ~1.4k tokens
- SKILL.md length
- 601 words
- Files
- 1
- Skills in repo
- 24
- Repo updated
- First seen
- Licence
- MIT
At a glance
Read, send, draft, delete, and organize Gmail emails. An agent skill from aws-samples/sample-strands-agent-with-agentcore.
- Tasks that involve Email management
- SKILL.md covers Available Tools, Usage Guidelines, Common Operations and Bulk Deletion, plus 1 more section
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Gmail is an agent skill from aws-samples/sample-strands-agent-with-agentcore, published by the product's own GitHub organization. Read, send, draft, delete, and organize Gmail emails
Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Productivity & Automation, covering Email management. It works with Gmail. The repository describes itself as: Reference architecture for agentic AI chatbots with Strands Agents and Amazon Bedrock AgentCore. The licence is MIT.
When your agent uses it
- Tasks that involve Email management
Example prompts
- “/gmail”
What it can do on your machine
Read from SKILL.md and the folder at commit 6dd9d13. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Gmail loads about 1.4k tokens when it runs. Until then it costs about 15 tokens; SKILL.md has 601 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from aws-samples/sample-strands-agent-with-agentcore at commit 6dd9d13, republished under its MIT licence (© aws-samples). 601 words, ~1,408 tokens.
Download SKILL.mdSave it as
.claude/skills/gmail/SKILL.md (or your agent's skills folder).- name
- gmail
- description
- Read, send, draft, delete, and organize Gmail emails
Gmail
Available Tools
list_labels(): List all Gmail labels (system: INBOX, SENT, TRASH, SPAM, DRAFT, IMPORTANT, STARRED, UNREAD; plus user-created labels).
list_emails(label?, max_results?, include_spam_trash?): List emails by label.
label(string, optional, default: "INBOX"): Label to filter by (INBOX, SENT, DRAFT, TRASH, SPAM, STARRED, IMPORTANT, or custom label ID)max_results(integer, optional, default: 10, max: 100): Number of emails to returninclude_spam_trash(boolean, optional, default: false): Include SPAM and TRASH
search_emails(query, max_results?): Search Gmail using query syntax.
query(string, required): Gmail search query (from:, to:, subject:, is:unread, has:attachment, after:, before:, older_than:, newer_than:)max_results(integer, optional, default: 10, max: 50): Number of results
read_email(message_id): Read a full email including body and attachments.
message_id(string, required): Gmail message ID (from list_emails or search_emails)
send_email(to, subject, body, cc?, bcc?, reply_to?, in_reply_to?, html_body?): Send an email.
to(string, required): Recipient(s), comma-separatedsubject(string, required): Email subjectbody(string, required): Plain text email bodycc(string, optional): CC recipient(s)bcc(string, optional): BCC recipient(s)reply_to(string, optional): Reply-To addressin_reply_to(string, optional): Message-ID to reply to (for threading)html_body(string, optional): HTML version of email body
draft_email(to, subject, body, cc?, bcc?, reply_to?, in_reply_to?, html_body?): Create a draft for later editing/sending. Same parameters as
send_email.delete_email(message_id, permanent?): Delete an email.
message_id(string, required): Gmail message IDpermanent(boolean, optional, default: false): If true, permanently delete; if false, move to Trash
bulk_delete_emails(query, reason, max_delete?): Permanently delete multiple emails by query. Cannot be undone.
query(string, required): Gmail search query to find emailsreason(string, required): Human-readable explanation (shown to user for approval)max_delete(integer, optional, default: 50, max: 100): Maximum emails to delete
modify_email(message_id, add_labels?, remove_labels?): Add/remove labels on an email.
message_id(string, required): Gmail message IDadd_labels(string, optional): Comma-separated label IDs to add (e.g., "STARRED,IMPORTANT")remove_labels(string, optional): Comma-separated label IDs to remove (e.g., "UNREAD,INBOX")
get_email_thread(thread_id): Get all messages in an email thread/conversation.
thread_id(string, required): Gmail thread ID (from read_email or search_emails)
Usage Guidelines
- Call
list_emailsdirectly for standard labels such as INBOX, SENT, DRAFT, TRASH, SPAM, STARRED, and IMPORTANT. Uselist_labelsonly when the user asks for a custom label or the label name is unknown. - Gmail search query syntax:
from:sender,to:recipient,subject:text,is:unread,has:attachment,after:2024/01/01,before:2024/12/31. - Use
get_email_threadto view entire conversation context before replying.
Show full SKILL.md (230 more words)Show less
Common Operations
Label operations via modify_email:
| Operation | Parameters |
|---|---|
| Mark as read | remove_labels="UNREAD" |
| Mark as unread | add_labels="UNREAD" |
| Archive | remove_labels="INBOX" |
| Star | add_labels="STARRED" |
| Unstar | remove_labels="STARRED" |
| Mark important | add_labels="IMPORTANT" |
Bulk Deletion
bulk_delete_emails(query, reason) permanently deletes all emails matching a Gmail query. This cannot be undone.
- Always provide a
reasonparameter explaining the intent. - Always explain what will be deleted and get user confirmation before calling.
Common queries:
- Spam cleanup:
"is:spam older_than:7d" - Old unread:
"in:inbox is:unread older_than:14d" - Promotions purge:
"category:promotions older_than:30d" - From specific sender:
"from:noreply@example.com older_than:30d"
UI Guidance (from tools-config)
Gmail Tool Usage:
- list_labels: Discover custom labels when the requested label is unknown
- list_emails: Browse emails by label (INBOX, SENT, DRAFT, TRASH, etc.)
- search_emails: Use Gmail query syntax (from:, to:, subject:, is:unread, has:attachment, after:, before:)
- read_email: Get full email content with attachments
- send_email: Send emails with optional CC, BCC, and HTML body
- draft_email: Create drafts for later editing/sending
- delete_email: Move to trash (permanent=True for permanent deletion)
- bulk_delete_emails: Permanently delete multiple emails by query (requires user approval)
- modify_email: Add/remove labels (mark read: remove UNREAD, archive: remove INBOX, star: add STARRED)
- get_email_thread: View entire conversation thread
Bulk Deletion (bulk_delete_emails):
- Use for spam cleanup, old email purge, etc.
- Always provide 'reason' parameter explaining the intent
- Common queries: "is:spam older_than:7d", "in:inbox is:unread older_than:14d", "category:promotions older_than:30d"
- WARNING: Permanently deletes emails - cannot be recovered
Common Operations:
- Mark as read: modify_email(id, remove_labels="UNREAD")
- Archive: modify_email(id, remove_labels="INBOX")
- Star: modify_email(id, add_labels="STARRED")
- Mark important: modify_email(id, add_labels="IMPORTANT")
© aws-samples, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in chatbot-app/agentcore/skills/gmail of aws-samples/sample-strands-agent-with-agentcore.
Open the folder on GitHubat commit 6dd9d13
Compare with similar skills
Gmail next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Gmail this skillaws-samples/sample-strands-agent-with-agentcore | 194 | — | ~1.4k | Automated safety check: Pass | MIT | |
| Career-Ops Gmail Lead Plugincareer-ops-hq/career-ops | 74k | — | ~233 | Automated safety check: Notes | MIT | |
| Gmailteam-attention/plugins-for-claude-natives | 825 | — | ~967 | Automated safety check: Pass | MIT | |
| Connect Apps with ComposioComposioHQ/awesome-claude-skills | 77k | 3 repos | ~557 | Automated safety check: Pass | None | |
| Gmail Emailopen-gitagent/gitagent | 710 | — | ~235 | Automated safety check: Notes | MIT | |
| Zeleremorses/zele | 299 | — | ~1.3k | Automated safety check: Pass | None |
Similar skills
Gmail
team-attention/plugins-for-claude-natives
This skill should be used when the user asks to "check email", "read emails", "send email", "reply to email", "search inbox", or manages Gmail.
Connect Apps with Composio
ComposioHQ/awesome-claude-skills
Connects an agent to 1000+ external apps through the Composio Tool Router plugin, so it can actually send emails, create issues and post messages instead of only drafting them.
Gmail Email
open-gitagent/gitagent
Send emails via Gmail SMTP using App Password authentication.
Zele
remorses/zele
zele is a multi-account email and calendar CLI for Gmail, IMAP/SMTP (Fastmail, Outlook, any provider), and Google Calendar.
Google Workspace
yc-software/qm
Read and act on the user's Gmail, Google Calendar, and Google Tasks through per-user OAuth.
More from aws-samples/sample-strands-agent-with-agentcore
All 24 skills in this repo- Official
Doc Coauthoring
aws-samples/sample-strands-agent-with-agentcore
Guide users through a structured workflow for co-authoring documentation.
- Official
Code Interpreter
aws-samples/sample-strands-agent-with-agentcore
Test and prototype code in a sandboxed environment. An agent skill from aws-samples/sample-strands-agent-with-agentcore.
- Official
Research Agent
aws-samples/sample-strands-agent-with-agentcore
Deep research with structured reports and charts. An agent skill from aws-samples/sample-strands-agent-with-agentcore.
- Official
Workspace
aws-samples/sample-strands-agent-with-agentcore
Read and write files in the shared session workspace. An agent skill from aws-samples/sample-strands-agent-with-agentcore.
- Official
Code Agent
aws-samples/sample-strands-agent-with-agentcore
Autonomous coding agent. An agent skill from aws-samples/sample-strands-agent-with-agentcore.
- Official
Delegate Work
aws-samples/sample-strands-agent-with-agentcore
Delegate one independent, context-heavy task to an isolated asynchronous analyst or reviewer.
Related
Works with
Categories
Questions about Gmail
What does Gmail do?
Read, send, draft, delete, and organize Gmail emails. An agent skill from aws-samples/sample-strands-agent-with-agentcore. Gmail is an agent skill from aws-samples/sample-strands-agent-with-agentcore, published by the product's own GitHub organization.
When should I use Gmail?
Gmail fits situations like: tasks that involve Email management.
How do I install Gmail in Claude Code?
Run `npx skills add aws-samples/sample-strands-agent-with-agentcore --skill gmail -a claude-code`. Or copy the skill folder (chatbot-app/agentcore/skills/gmail in aws-samples/sample-strands-agent-with-agentcore) into .claude/skills/gmail in your project. Claude Code loads it when a task matches its description.
How do I install Gmail in Codex?
Run `npx skills add aws-samples/sample-strands-agent-with-agentcore --skill gmail -a codex`. Or copy the skill folder (chatbot-app/agentcore/skills/gmail in aws-samples/sample-strands-agent-with-agentcore) into .agents/skills/gmail in your project. Codex loads it when a task matches its description.
Can I use Gmail in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aws-samples/sample-strands-agent-with-agentcore --skill gmail -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gmail, .gemini/skills/gmail, .github/skills/gmail and .opencode/skills/gmail in your project.
What does Gmail need to run?
SKILL.md names no scripts, command-line tools or credentials: Gmail is instructions for the agent only.
Does Gmail access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Gmail safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Gmail use?
Gmail is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Gmail use?
About 1.4k tokens (SKILL.md is roughly 5.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Gmail?
Skills that share tags, products or a category with Gmail: Career-Ops Gmail Lead Plugin (career-ops-hq/career-ops, 74k stars), Gmail (team-attention/plugins-for-claude-natives, 825 stars), Connect Apps with Composio (ComposioHQ/awesome-claude-skills, 77k stars) and Gmail Email (open-gitagent/gitagent, 710 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Gmail?
aws-samples (a GitHub organization, an official publisher) maintains it in aws-samples/sample-strands-agent-with-agentcore, which has 194 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 6, 2026.
Source: aws-samples/sample-strands-agent-with-agentcore on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.