google-sheets

google-sheets is a skill for Claude Code, Codex from Open-Curiosity/gini-agent. It costs 21 tokens per session (2,873 once invoked), scanned A, original, MIT.

A Google Sheets interface for reading and editing spreadsheet cells. It can append rows, update values, and apply structured batch changes through the Google Sheets API.

In plain words
What is it for?
Use it to read ranges, add rows, change cell values, or perform grouped spreadsheet updates in Google Sheets.
Why use it?
It provides a direct way to work with spreadsheet data without manually copying values through the browser. It also separates cell editing from Google Drive tasks such as sharing, copying, moving, or trashing files.

Skill for Claude CodeCodex

About the project

Gini Agent is a personal AI-agent runtime that manages conversations, runs, tasks, approvals, memory, skills, jobs, tools, traces, audit events, and runtime health across its clients. It is for an agent that can remember, learn from task outcomes, and operate through desktop or mobile interfaces with user controls. Catalogue add-ons extend the runtime with skills and instructions.

Open-Curiosity/gini-agent · 1,914 stars · on GitHub

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/open-curiosity/gini-agent/google-sheets
Any agent
npx skills add Open-Curiosity/gini-agent --skill google-sheets
Clone the repo
git clone --depth 1 https://github.com/Open-Curiosity/gini-agent

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for google-sheets

README.md
[![agentmods](https://agentmods.dev/badge/skills/open-curiosity/gini-agent/google-sheets.svg)](https://agentmods.dev/skills/open-curiosity/gini-agent/google-sheets)
Your own site
<a href="https://agentmods.dev/skills/open-curiosity/gini-agent/google-sheets"><img src="https://agentmods.dev/badge/skills/open-curiosity/gini-agent/google-sheets.svg" alt="Measured on agentmods" height="20"></a>
Per session 21 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,873 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00021 $0.02873
Opus 5 $0.00010 $0.01437
Sonnet 5 $0.00004 $0.00575
Haiku 4.5 $0.00002 $0.00287

Measured 5d ago against content hash 41e0c8203c81, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

google-sheets scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/google/google-sheets/SKILL.md · 210 lines

How it starts

The opening of the file, as written. The whole thing — 210 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Google Sheets

Use gws sheets to create spreadsheets, read cell ranges, append rows, update values, and run structured batch updates against the Sheets v4 API. This is the content surface for Google Sheets — for the file as an object (sharing, copying, moving, trashing) use google-drive instead.

Prerequisites

  • If this deployment is managed/hosted, the Google credential is already provisioned at sign-in — gws is installed and authenticated, so skip the setup flow below and run gws directly. Scopes are fixed at sign-in on a managed deployment: when a call fails with scope required or HTTP 401, tell the user which action needs a scope their account wasn't granted, instead of trying to set anything up. (The scope list below still describes which verb needs which scope.)
  • gws installed and authenticated. If gws is not on PATH OR gws auth status reports no authenticated user, do NOT silently call setup. Instead, in a single short reply to the user:
    1. State plainly what's missing — e.g. "Google Workspace access isn't set up on this machine yet" or "your Google sign-in has expired."
    2. Ask one sentence: "Want me to walk you through setting it up?" Wait for the user's answer.
    3. If they say yes, call read_skill with name google-workspace-setup and run that skill's onboarding flow turn-by-turn. If they say no or ask to defer, acknowledge briefly and stop — do not retry the original request.
  • Apply the same flow when any gws sheets ... call fails mid-task with command not found / ENOENT, HTTP 401, "no credentials", or "scope required". Don't report the failure as a dead end — surface the missing prerequisite and ask if the user wants to set it up before moving on.
  • OAuth scopes the user picked at login must cover the verbs the agent will use:
    • Read and write Sheets: sheets (maps to https://www.googleapis.com/auth/spreadsheets)
    • Read-only Sheets: pass --scopes "https://www.googleapis.com/auth/spreadsheets.readonly" at login
    • Find sheets by title (or list recent sheets) before reading: pair with drive.readonly
    • The Sheets API also accepts the broader drive scope, which covers finding sheets by title too — an account with a full drive grant needs no separate sheets scope

Read the full file on GitHub · 210 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 210 lines · 21 tokens per session scan A 41e0c8203c81

Subscribe to this mod's changes

google-sheets is a skill published in the GitHub repository Open-Curiosity/gini-agent (1,914 stars, last pushed 1mo ago), licensed MIT. It adds 21 tokens to every session and 2,873 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

xlsx

Read, edit, or create Microsoft Excel .xlsx workbooks. Trigger this skill whenever the user mentions a spreadsheet, .xlsx file, workbook, sheet, formula, pivot table, or asks to extract tabular data, modify a sheet, or build a workbook from rows. Three execution paths: structured inspection, in-place cell edits, and…

opensquilla/opensquilla · 108 tokens

liteparse

Use this skill when the user asks to parse, perform multi-format document conversion or spatially extract text from an unstructured file (PDF, DOCX, PPTX, XLSX, images, etc.) locally without cloud dependencies.

synthetic-sciences/openscience · 49 tokens

meta-knowledge-base-bootstrap

Bootstrap a domain knowledge base from a single seed (URL / PDF path / git repo / free-text topic): classify source → ingest with the right tool → persist to memory + xlsx index.

opensquilla/opensquilla · 45 tokens

meta-multi-format-export-pack

From one piece of source content, render four deliverables: .docx report, .pptx slides, .xlsx data, and an HTML/PDF public version.

opensquilla/opensquilla · 41 tokens

tencent-docs

腾讯文档(docs.qq.com)-在线云文档平台,是创建、编辑、管理文档的首选 skill。涉及"新建/创建/编辑/读取/查看/搜索文档"、"保存文件"、"云文档"、"腾讯文档"、"docs.qq.com"等操作,请优先使用本 skill。支持能力:(1) 创建各类在线文档(文档/Word/Excel/幻灯片/思维导图/流程图/智能表格/收集表)(2) 管理知识库空间(创建空间、查询空间列表)(3) 管理空间节点、文件夹结构 (4) 读取/搜索文档内容 (5) 编辑操作智能表 (6) 编辑操作在线文档 (7) 文件管理(重命名、移动、删除、复制、导入导出)(8) 网页剪藏、本地文件/html/文档上云。.

Pinvou/pinvou-agent · 210 tokens

meta-spreadsheet-insight

Turn an Excel workbook into business insight: structured read → trend/anomaly summary → write back to a new 'Insights' sheet → persist KPIs to memory.

opensquilla/opensquilla · 39 tokens