New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Gmail

by greatSumini in greatSumini/cc-system

gogcli를 사용하여 Gmail 메일을 검색, 조회, 발송하는 skill. An agent skill from greatSumini/cc-system.

MITAuto-check passedProductivity & Automation

Install Gmail

skills CLI
$ npx skills add greatSumini/cc-system --skill gmail -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install greatSumini/cc-system gmail --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/greatSumini/cc-system.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/gmail .claude/skills/gmail && rm -rf skills-src

Use ~/.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/

Facts

Skill name
gmail
GitHub stars
438
Token cost
~838 tokens
SKILL.md length
324 words
Files
2 (incl. references)
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

gogcli를 사용하여 Gmail 메일을 검색, 조회, 발송하는 skill. An agent skill from greatSumini/cc-system.

  • Works in 4 steps: gogcli 설치 확인 → 인증 확인 → 요청 분류 및 실행 → …
  • Tasks that involve Email management
  • SKILL.md covers 디렉토리 구조, 플로우, Invariants and 주의사항
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Gmail is an agent skill from greatSumini/cc-system. gogcli를 사용하여 Gmail 메일을 검색, 조회, 발송하는 skill. "메일 검색해줘", "이메일 보내줘", "gmail search", "메일 확인해줘", "최근 메일", "메일 답장", "gmail send", "메일 보내줘", "안 읽은 메일" 등 Gmail 관련 요청에 트리거된다.

Its SKILL.md is about 840 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/gog-gmail-commands.md`).

It sits in Productivity & Automation, covering Email management. It works with Gmail. The licence is MIT.

When your agent uses it

  • Tasks that involve Email management

Example prompts

  • “gmail search”
  • “gmail send”
  • “/gmail”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. gogcli 설치 확인
  2. 인증 확인
  3. 요청 분류 및 실행
  4. 결과 출력

What it can do on your machine

Read from SKILL.md and the folder at commit 172bdd4. 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 (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • console.cloud.google.com

    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 838 tokens when it runs, and up to ~1.6k if it reads all its reference files. Until then it costs about 43 tokens; SKILL.md has 324 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~838
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.6k

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 greatSumini/cc-system at commit 172bdd4, republished under its MIT licence (© greatSumini). 324 words, ~838 tokens.

Download SKILL.mdSave it as .claude/skills/gmail/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
gmail
description
gogcli를 사용하여 Gmail 메일을 검색, 조회, 발송하는 skill. "메일 검색해줘", "이메일 보내줘", "gmail search", "메일 확인해줘", "최근 메일", "메일 답장", "gmail send", "메일 보내줘", "안 읽은 메일" 등 Gmail 관련 요청에 트리거된다.

Gmail — gogcli 기반 메일 검색/조회/발송

gogcli(gog) CLI를 사용하여 Gmail 메일을 검색, 조회, 발송한다.

디렉토리 구조

gmail/
├── SKILL.md
└── references/
    └── gog-gmail-commands.md   # 주요 명령어 레퍼런스

스크립트 없이 gog CLI를 직접 실행한다.

플로우

1. gogcli 설치 확인
bash
which gog

명령이 실패하면 사용자에게 설치를 안내한다:

gogcli 설치 안내

bash
brew install gogcli

설치 완료 후 다시 시도해주세요.

설치가 확인되면 다음 단계로 진행한다.

2. 인증 확인
bash
gog auth list

계정이 없으면 OAuth 설정을 안내한다:

Gmail 인증 설정 가이드

  1. Google Cloud Console에서 프로젝트 생성
  2. Gmail API 활성화
  3. OAuth 동의 화면 설정 → 테스트 사용자 추가
  4. OAuth 클라이언트 생성 → "Desktop app" → JSON 다운로드
  5. 터미널에서 아래 명령 실행:
bash
gog auth credentials ~/Downloads/client_secret_....json
gog auth add <your-email@gmail.com> --services gmail

브라우저가 열리면 Google 계정으로 로그인하여 권한을 허용해주세요.

인증이 확인되면 GOG_ACCOUNT 환경변수 또는 --account 플래그로 계정을 지정한다.

계정 선택 규칙
  • 등록된 계정이 1개뿐이면 해당 계정을 그대로 사용한다.
  • 등록된 계정이 여러 개인 경우:
    • 사용자가 계정을 명시했거나, 요청 맥락에서 어떤 계정을 써야 하는지 파악 가능하면 해당 계정을 사용한다.
    • 어떤 계정을 써야 할지 파악할 수 없으면 AskUserQuestion으로 사용자에게 어떤 계정을 사용할지 물어본다.
3. 요청 분류 및 실행

사용자 요청을 아래 중 하나로 분류하여 실행한다.

메일 검색
bash
gog gmail search '<Gmail 검색 쿼리>' --max <N> --json

자주 쓰는 검색 쿼리:

  • 최근 N일: newer_than:7d
  • 안 읽은 메일: is:unread
  • 특정 발신자: from:someone@example.com
  • 첨부파일 있는 메일: has:attachment
  • 복합 조건: from:boss@example.com newer_than:3d is:unread
메시지 수준 검색 (본문 포함)
bash
gog gmail messages search '<query>' --max <N> --include-body --json
스레드 조회
bash
gog gmail thread get <threadId> --json
메시지 조회
bash
gog gmail get <messageId> --json
메일 발송
bash
gog gmail send --to <수신자> --subject "<제목>" --body "<본문>"

CC/BCC 추가:

bash
gog gmail send --to <수신자> --cc <참조> --bcc <숨은참조> --subject "<제목>" --body "<본문>"

HTML 본문:

bash
gog gmail send --to <수신자> --subject "<제목>" --body "Plain fallback" --body-html "<p>HTML 본문</p>"
답장
bash
gog gmail send --reply-to-message-id <messageId> --quote --to <수신자> --subject "Re: <원제목>" --body "<답장 내용>"
라벨 조회
bash
gog gmail labels list --json
첨부파일 다운로드
bash
gog gmail thread get <threadId> --download --out-dir <다운로드경로>
초안 관리
bash
# 초안 목록
gog gmail drafts list --json

# 초안 생성
gog gmail drafts create --to <수신자> --subject "<제목>" --body "<본문>"

# 초안 발송
gog gmail drafts send <draftId>
4. 결과 출력

JSON 결과를 파싱하여 사용자에게 읽기 좋게 정리한다:

  • 검색 결과: 발신자, 제목, 날짜, 스니펫을 테이블 형태로
  • 메시지 조회: 헤더(From/To/Subject/Date) + 본문
  • 발송 결과: 성공 여부와 메시지 ID

Invariants

  • 조회 명령에는 항상 --json 플래그를 붙여 파싱 가능한 출력을 얻는다
  • 메일 발송은 실행 전 반드시 사용자에게 수신자, 제목, 본문을 확인받는다
  • gogcli 미설치 또는 미인증 상태에서는 명령을 실행하지 않고 설정 안내를 진행한다
  • OAuth 자격증명은 gogcli 자체 keyring에 저장된다 — skill 디렉토리에 저장하지 않는다
  • GOG_ACCOUNT 환경변수가 설정되어 있으면 우선 사용한다

주의사항

  • Gmail 검색 쿼리는 Gmail 검색 문법을 따른다 (Google 검색 연산자).
  • 대량 조회 시 --max 플래그로 결과 수를 제한한다.
  • 발송 시 --track 옵션으로 읽음 추적이 가능하나, 사전 설정이 필요하다.

© greatSumini, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in .claude/skills/gmail of greatSumini/cc-system.

  • SKILL.md
  • references/gog-gmail-commands.md

Open the folder on GitHubat commit 172bdd4

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.

Gmail compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gmail this skillgreatSumini/cc-system438—~838Automated safety check: PassMIT
Career-Ops Gmail Lead Plugincareer-ops-hq/career-ops74k—~233Automated safety check: NotesMIT
Gmailteam-attention/plugins-for-claude-natives825—~967Automated safety check: PassMIT
Connect Apps with ComposioComposioHQ/awesome-claude-skills77k3 repos~557Automated safety check: PassNone
Gmail Emailopen-gitagent/gitagent710—~235Automated safety check: NotesMIT
Zeleremorses/zele299—~1.3kAutomated safety check: PassNone

Similar skills

  • 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.

    74k GitHub stars~233 tokensUpdated today
    Productivity & AutomationAuto-check: notes

  • 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.

    825 GitHub stars~967 tokensUpdated 5 mo ago
    Productivity & AutomationAuto-check passed

  • 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.

    77k GitHub starsUsed in 3 repos~557 tokens
    Productivity & AutomationAuto-check passed

  • Gmail Email

    open-gitagent/gitagent

    Send emails via Gmail SMTP using App Password authentication.

    710 GitHub stars~235 tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check: notes

  • Zele

    remorses/zele

    zele is a multi-account email and calendar CLI for Gmail, IMAP/SMTP (Fastmail, Outlook, any provider), and Google Calendar.

    299 GitHub stars~1.3k tokensUpdated 6 days ago
    Productivity & AutomationAuto-check passed

  • Google Workspace

    yc-software/qm

    Read and act on the user's Gmail, Google Calendar, and Google Tasks through per-user OAuth.

    15k GitHub stars~1.8k tokensUpdated today
    Productivity & AutomationAuto-check passed

More from greatSumini/cc-system

All 12 skills in this repo

  • Slash Command Creator

    greatSumini/cc-system

    Guide for creating Claude Code slash commands. An agent skill from greatSumini/cc-system.

    438 GitHub stars~773 tokensUpdated 4 mo ago
    Auto-check passed

  • Subagent Creator

    greatSumini/cc-system

    Create specialized Claude Code sub-agents with custom system prompts and tool configurations.

    438 GitHub stars~958 tokensUpdated 4 mo ago
    Auto-check passed

  • Cc Usage Audit

    greatSumini/cc-system

    한 프로젝트에서 사용자가 Claude Code에 입력한 프롬프트·작업 이력을 분석해 (1) 사용 패턴 정량화, (2) 사용자의 개발 철학 추출(근거 인용), (3) 그 철학을 렌즈로 한 메타 시스템(하니스·게이트·CI·프로세스) audit, (4) 우선순위가 매겨진 개선점 발굴을 수행한다.

    438 GitHub stars~586 tokensUpdated 4 mo ago
    Auto-check passed

  • Hook Creator

    greatSumini/cc-system

    Create and configure Claude Code hooks for customizing agent behavior.

    438 GitHub stars~662 tokensUpdated 4 mo ago
    Auto-check: notes

  • Youtube Collector

    greatSumini/cc-system

    유튜브 채널을 등록하고 새 컨텐츠를 수집하여 자막 기반 요약을 생성하는 skill. An agent skill from greatSumini/cc-system.

    438 GitHub stars~846 tokensUpdated 4 mo ago
    Auto-check passed

  • Ship

    greatSumini/cc-system

    지금까지의 작업을 한 번에 출하한다 — 커밋 → push → PR 생성 → squash merge. An agent skill from greatSumini/cc-system.

    438 GitHub stars~697 tokensUpdated 4 mo ago
    Auto-check passed

Works with

Categories

Questions about Gmail

What does Gmail do?

gogcli를 사용하여 Gmail 메일을 검색, 조회, 발송하는 skill. An agent skill from greatSumini/cc-system. Gmail is an agent skill from greatSumini/cc-system. gogcli를 사용하여 Gmail 메일을 검색, 조회, 발송하는 skill.

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 greatSumini/cc-system --skill gmail -a claude-code`. Or copy the skill folder (.claude/skills/gmail in greatSumini/cc-system) 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 greatSumini/cc-system --skill gmail -a codex`. Or copy the skill folder (.claude/skills/gmail in greatSumini/cc-system) 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 greatSumini/cc-system --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 names 1 domain. As links in the text: console.cloud.google.com. 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 838 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 770 tokens, read only when the agent opens those files.

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?

greatSumini (a GitHub user) maintains it in greatSumini/cc-system, which has 438 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on June 9, 2026.

Source: greatSumini/cc-system on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.