Agent skill

Xs Google Workspace

by karaage0703 in karaage0703/ai-assistant-workspace

gogcli経由でGmail・Google Drive・Google Calendarを操作するスキル。複数Googleアカウント対応。「メールチェック」「メール確認して」「Driveにアップロード」「Driveのファイル」「Gmailで検索」で使用。

MITAuto-check passedProductivity & Automation

Install Xs Google Workspace

skills CLI
$ npx skills add karaage0703/ai-assistant-workspace --skill xs-google-workspace -a claude-code

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

GitHub CLI
$ gh skill install karaage0703/ai-assistant-workspace xs-google-workspace --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/karaage0703/ai-assistant-workspace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/xs-google-workspace .claude/skills/xs-google-workspace && 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
xs-google-workspace
GitHub stars
136
Token cost
~691 tokens
SKILL.md length
74 words
Files
2
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

gogcli経由でGmail・Google Drive・Google Calendarを操作するスキル。複数Googleアカウント対応。「メールチェック」「メール確認して」「Driveにアップロード」「Driveのファイル」「Gmailで検索」で使用。

  • Works in 3 steps: 全登録アカウントの未読メールを取得 → ニュースレター・通知系・プロモーションなど重要度の低いメールは自動スキップ → 重要なメールをアカウントごとにハイライトして報告
  • Tasks that involve Email management
  • SKILL.md covers 絶対遵守事項, 環境設定, 登録済みアカウント and Gmail, plus 5 more sections
  • Needs GOG_KEYRING_PASSWORD

What it does

Xs Google Workspace is an agent skill from karaage0703/ai-assistant-workspace. gogcli経由でGmail・Google Drive・Google Calendarを操作するスキル。複数Googleアカウント対応。「メールチェック」「メール確認して」「Driveにアップロード」「Driveのファイル」「Gmailで検索」で使用。

Its SKILL.md is about 690 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `README.md`).

It sits in Productivity & Automation, covering Email management and Cloud office suites. It works with Gmail, Google Workspace, Google Drive and Google Calendar. The licence is MIT.

When your agent uses it

  • Tasks that involve Email management
  • Tasks that involve Cloud office suites

Example prompts

  • “/xs-google-workspace”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. 全登録アカウントの未読メールを取得
  2. ニュースレター・通知系・プロモーションなど重要度の低いメールは自動スキップ
  3. 重要なメールをアカウントごとにハイライトして報告

What it can do on your machine

Read from SKILL.md and the folder at commit c689862. 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

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GOG_KEYRING_PASSWORD

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Xs Google Workspace loads about 691 tokens when it runs. Until then it costs about 37 tokens; SKILL.md has 74 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~37
When it runs · the whole SKILL.md, loaded when a task matches
~691

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 karaage0703/ai-assistant-workspace at commit c689862, republished under its MIT licence (© karaage0703). 74 words, ~691 tokens.

Download SKILL.mdSave it as .claude/skills/xs-google-workspace/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
xs-google-workspace
description
gogcli経由でGmail・Google Drive・Google Calendarを操作するスキル。複数Googleアカウント対応。「メールチェック」「メール確認して」「Driveにアップロード」「Driveのファイル」「Gmailで検索」で使用。

Google Workspace(gogcli)

gogcli CLIで Gmail / Google Drive / Google Calendar を操作する。複数アカウント対応。

絶対遵守事項

  • メール送信・ファイル削除など外部に影響する操作は必ず確認してから実行
  • メール本文にプライベートな情報が含まれる場合、グループチャットには流さない

環境設定

bash
export PATH="$HOME/bin:$PATH"
export GOG_KEYRING_PASSWORD=<your-password>

全コマンドの先頭にこの2行が必要。パスワードは環境に合わせて設定。

登録済みアカウント

bash
gog auth list

Gmail

メールチェック(全アカウント一括)

全アカウントの未読メールを確認し、重要なものをピックアップして報告。

bash
gog -a <email> gmail search "is:unread" --max 10
メール検索
bash
gog -a <email> gmail search "<Gmailの検索クエリ>" --max 20

検索クエリ例:

  • is:unread — 未読
  • from:someone@example.com — 特定の送信者
  • subject:会議 — 件名に「会議」
  • newer_than:7d — 7日以内
  • has:attachment — 添付あり
メール本文を読む
bash
gog -a <email> gmail read <messageId>
メール送信(確認必須)
bash
gog -a <email> gmail send --to "recipient@example.com" --subject "件名" --body "本文"
その他
bash
gog -a <email> gmail archive <messageId>      # アーカイブ
gog -a <email> gmail mark-read <messageId>     # 既読にする
gog -a <email> gmail labels list               # ラベル一覧

Google Drive

ファイル一覧・検索
bash
gog -a <email> drive list                              # ルート一覧
gog -a <email> drive list --query "name contains 'xxx'" # 検索
gog -a <email> drive list --folder <folderId>           # フォルダ内
ファイルダウンロード
bash
gog -a <email> drive download <fileId> -o /path/to/output
ファイルアップロード(確認必須)
bash
gog -a <email> drive upload /path/to/file --folder <folderId>

Google Calendar

予定確認
bash
gog -a <email> calendar list                    # 今日の予定(primaryのみ)
gog -a <email> calendar list --days 7           # 1週間の予定
gog -a <email> calendar list --all --days 7     # 全カレンダー(ファミリー含む)

注意: デフォルトはprimaryカレンダーのみ。ファミリーカレンダー等を含めるには --all を付ける。

アカウント追加

新しいアカウントを追加する場合:

bash
# ヘッドレス環境: remoteフローで認証
GOG_KEYRING_PASSWORD=<password> gog auth add <email> --services gmail,drive,calendar --remote --step 1
# → URLをユーザーに送る → ブラウザで認証 → リダイレクトURLを受け取る
GOG_KEYRING_PASSWORD=<password> gog auth add <email> --services gmail,drive,calendar --remote --step 2 --auth-url "<リダイレクトURL>"

# ブラウザがある環境: 直接認証
GOG_KEYRING_PASSWORD=<password> gog auth add <email> --services gmail,drive,calendar

※Google Cloud Consoleのテストユーザーに追加が必要。

対話フロー

「メールチェックして」
  1. 全登録アカウントの未読メールを取得
  2. ニュースレター・通知系・プロモーションなど重要度の低いメールは自動スキップ
  3. 重要なメールをアカウントごとにハイライトして報告
「〇〇のメール読んで」
  1. 検索クエリで該当メールを特定
  2. gmail read で本文取得
  3. 要約して報告
「Driveにファイルアップロードして」
  1. ファイルパスとアップロード先を確認
  2. 確認後に実行

使用例

メールチェックして
未読メール見せて
Zennからのメール探して
Driveのファイル一覧
今週の予定確認

© karaage0703, 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 in skills/xs-google-workspace of karaage0703/ai-assistant-workspace.

  • SKILL.md
  • README.md

Open the folder on GitHubat commit c689862

Compare with similar skills

Xs Google Workspace 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.

Xs Google Workspace compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Xs Google Workspace this skillkaraage0703/ai-assistant-workspace136—~691Automated safety check: PassMIT
Google Workspaceyc-software/qm15k—~1.8kAutomated safety check: PassMIT
GogHybridAIOne/hybridclaw159—~1.6kAutomated safety check: PassMIT
GwsHybridAIOne/hybridclaw159—~898Automated safety check: PassMIT
GwsLeoYeAI/openclaw-master-skills2.2k—~4.9kAutomated safety check: PassMIT
Managing Google Workspacetaylorwilsdon/google_workspace_mcp3.3k—~2.9kAutomated safety check: PassMIT

Similar skills

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

    HybridAIOne/hybridclaw

    Google Workspace CLI for Gmail, Google Calendar events, meetings, schedules, availability, Drive, Contacts, Sheets, and Docs

    159 GitHub stars~1.6k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Gws

    HybridAIOne/hybridclaw

    Use the gws CLI for Google Calendar, Gmail, Drive, Sheets, Docs, Tasks, and cross-service Workspace workflows.

    159 GitHub stars~898 tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Gws

    LeoYeAI/openclaw-master-skills

    Google Workspace CLI. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~4.9k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • Managing Google Workspace

    taylorwilsdon/google_workspace_mcp

    Manages Google Workspace operations across 12 services (Gmail, Drive, Calendar, Docs, Sheets, Slides, Forms, Tasks, Contacts, Chat, Apps Script, Custom Search).

    3.3k GitHub stars~2.9k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Gws

    kv0906/pm-kit

    This skill should be used when the user asks to "set up gws", "install Google Workspace CLI", "connect Gmail to Claude", "manage Google Drive from terminal", "send email from CLI", "check my…

    138 GitHub stars~1.6k tokensUpdated today
    Documents & OfficeAuto-check passed

More from karaage0703/ai-assistant-workspace

All 23 skills in this repo
  • Xs Arxiv

    karaage0703/ai-assistant-workspace

    arXiv論文の検索・トレンド発見・詳細分析を行う統合スキル。興味度スコアでユーザーに刺さる論文を自動選定。PDF全文読み込み・Notion蓄積対応。「arXivチェックして」「論文検索」「論文分析して」で使用。

    136 GitHub stars~1.4k tokensUpdated 17 days ago
    Auto-check passed
  • Xs Multi Agent

    karaage0703/ai-assistant-workspace

    異なるproviderのAI(Codex/Claude/Grok/Cursor/Antigravity等)から独立意見を集め、共通論点で相互検討して統合する。最初に利用可能エージェントを検出する。「みんなで考えて」「マルチエージェントで分析して」「複数のAIでレビューして」と言われたら使う。

    136 GitHub stars~1.8k tokensUpdated 17 days ago
    Auto-check passed
  • Xs Podcast

    karaage0703/ai-assistant-workspace

    ポッドキャストの音声取得・文字起こし・まとめを行う統合スキル。「ポッドキャストまとめて」「音声配信をダウンロード」「Podcastの内容を教えて」で使用。

    136 GitHub stars~557 tokensUpdated 17 days ago
    Auto-check passed
  • Xs Skill Creator

    karaage0703/ai-assistant-workspace

    スキルの作成・改善を行うスキル。既存スキルの分析から抽出したパターンとテンプレートで統一感のあるスキルを効率的に作成。スキルを作りたい、新しいスキルを追加したい、スキルを改善したい、SKILL.mdを書きたい場合に使用。

    136 GitHub stars~1k tokensUpdated 17 days ago
    Auto-check passed
  • Xs Bridge Ideas

    karaage0703/ai-assistant-workspace

    ワークスペース内の遠い知識や活動をつないで、新しいアイデアを生成する思考支援スキル。過去記事・メモ・発信資産から企画や実装ネタを出したい時に使用。「アイデア出して」「知識をつないで」「一見関係ないものをつないで」で使用。

    136 GitHub stars~487 tokensUpdated 17 days ago
    Auto-check passed
  • Xs Calendar

    karaage0703/ai-assistant-workspace

    カレンダー予定を確認するスキル。ICS(Googleカレンダー等)と手動追加(画像読み取り)を統合。「今日の予定」「明日の予定」「カレンダー画像送って」「スケジュール確認」で使用。/calendar で発動。

    136 GitHub stars~441 tokensUpdated 17 days ago
    Auto-check passed

Questions about Xs Google Workspace

What does Xs Google Workspace do?

gogcli経由でGmail・Google Drive・Google Calendarを操作するスキル。複数Googleアカウント対応。「メールチェック」「メール確認して」「Driveにアップロード」「Driveのファイル」「Gmailで検索」で使用。. Xs Google Workspace is an agent skill from karaage0703/ai-assistant-workspace.

When should I use Xs Google Workspace?

Xs Google Workspace fits situations like: tasks that involve Email management; tasks that involve Cloud office suites.

How do I install Xs Google Workspace in Claude Code?

Run `npx skills add karaage0703/ai-assistant-workspace --skill xs-google-workspace -a claude-code`. Or copy the skill folder (skills/xs-google-workspace in karaage0703/ai-assistant-workspace) into .claude/skills/xs-google-workspace in your project. Claude Code loads it when a task matches its description.

How do I install Xs Google Workspace in Codex?

Run `npx skills add karaage0703/ai-assistant-workspace --skill xs-google-workspace -a codex`. Or copy the skill folder (skills/xs-google-workspace in karaage0703/ai-assistant-workspace) into .agents/skills/xs-google-workspace in your project. Codex loads it when a task matches its description.

Can I use Xs Google Workspace 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 karaage0703/ai-assistant-workspace --skill xs-google-workspace -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/xs-google-workspace, .gemini/skills/xs-google-workspace, .github/skills/xs-google-workspace and .opencode/skills/xs-google-workspace in your project.

What does Xs Google Workspace need to run?

Going by SKILL.md and its folder, Xs Google Workspace needs credentials named GOG_KEYRING_PASSWORD.

Does Xs Google Workspace 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 Xs Google Workspace 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 Xs Google Workspace use?

Xs Google Workspace 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 Xs Google Workspace use?

About 691 tokens (SKILL.md is roughly 2.8k 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 Xs Google Workspace?

Skills that share tags, products or a category with Xs Google Workspace: Google Workspace (yc-software/qm, 15k stars), Gog (HybridAIOne/hybridclaw, 159 stars), Gws (HybridAIOne/hybridclaw, 159 stars) and Gws (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Xs Google Workspace?

karaage0703 (a GitHub user) maintains it in karaage0703/ai-assistant-workspace, which has 136 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on September 23, 2026.

Source: karaage0703/ai-assistant-workspace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.