gws-quick-ref

gws-quick-ref is a skill for Claude Code, Codex from fakoli/fakoli-plugins. It costs 29 tokens per session (1,068 once invoked), scanned A, original, MIT.

A quick reference for the syntax and common options of the gws command-line tool for Google Workspace.

In plain words
What is it for?
Looking up how to call services, pass JSON parameters, limit response fields, paginate results, and choose output formats.
Why use it?
It reduces the need to remember command patterns, pagination, field selection, and output formats.

Skill for Claude CodeCodex

Part of the gws plugin — 94 skills, 15 commands, 11 agents shipped together

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/fakoli/fakoli-plugins/gws-quick-ref
Any agent
npx skills add fakoli/fakoli-plugins --skill gws-quick-ref
Clone the repo
git clone --depth 1 https://github.com/fakoli/fakoli-plugins

Made for: Claude Code, Codex.

Or install gws, the plugin that ships this one along with the rest of its 94 skills, 15 commands, 11 agents.

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 gws-quick-ref

README.md
[![agentmods](https://agentmods.dev/badge/skills/fakoli/fakoli-plugins/gws-quick-ref.svg)](https://agentmods.dev/skills/fakoli/fakoli-plugins/gws-quick-ref)
Your own site
<a href="https://agentmods.dev/skills/fakoli/fakoli-plugins/gws-quick-ref"><img src="https://agentmods.dev/badge/skills/fakoli/fakoli-plugins/gws-quick-ref.svg" alt="Measured on agentmods" height="20"></a>
Per session 29 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,068 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.00029 $0.01068
Opus 5 $0.00015 $0.00534
Sonnet 5 $0.00006 $0.00214
Haiku 4.5 $0.00003 $0.00107

Measured yesterday against content hash e4825ff7c007, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

gws-quick-ref 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 yesterday.

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.

plugins/gws/skills/gws-quick-ref/SKILL.md · 123 lines

How it starts

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

gws Quick Reference

Reference: See the gws-shared skill for auth, global flags, and security rules.

Quick reference card for the gws CLI syntax and patterns.

Core Syntax

gws <service> <resource> [sub-resource] <method> [flags]

Getting Help

gws --help                              # All services
gws <service> --help                    # Service resources
gws <service> <resource> --help         # Resource methods
gws <service> <resource> <method> --help  # Method flags

Key Flags

Flag Purpose Example
--params '<JSON>' URL/query parameters --params '{"userId": "me", "q": "is:unread"}'
--json '<JSON>' Request body (POST/PUT/PATCH) --json '{"name": "My File"}'
--fields '<MASK>' Limit response fields --fields "files(id,name)"
--format <FMT> Output format json, yaml, csv, table
--page-all Auto-paginate (NDJSON output) Streams all pages
--page-limit N Limit pagination pages --page-limit 3
--upload <PATH> Multipart file upload --upload ./file.pdf
--output <PATH> Download to file --output ./download.pdf
--dry-run Preview without executing Shows what would happen
--sanitize <TPL> Model Armor scan Scans response for injection

Common Patterns

1. Reading Data (GET/LIST)

# Always use --fields to minimize response size
gws drive files list \
  --params '{"q": "name contains \"Report\"", "pageSize": 10}' \
  --fields "files(id,name,mimeType)"

2. Writing Data (POST/PUT/PATCH)

# Always --dry-run first, then execute
gws calendar events insert \
  --params '{"calendarId": "primary"}' \
  --json '{"summary": "Meeting", "start": {...}, "end": {...}}' \
  --dry-run

3. Pagination

# Auto-paginate all results (NDJSON — one JSON object per line)
gws admin users list --params '{"domain": "example.com"}' --page-all

# Limit to N pages
gws drive files list --page-limit 3

Read the full file on GitHub · 123 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. yesterday First seen · 123 lines · 29 tokens per session scan A e4825ff7c007

Subscribe to this mod's changes

gws-quick-ref is a skill published in the GitHub repository fakoli/fakoli-plugins (4 stars, last pushed 26d ago), licensed MIT. It adds 29 tokens to every session and 1,068 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-09-03.

Related

Other skills, from other repositories

code-search

Select the right search tool (Grep, Glob, codebase-retrieval) to locate existing code, symbols, or files across the project's monorepo. Don't use it for creating new files, implementing features, or reviewing code quality.

atretyak1985/swarmery · 52 tokens

a-rules-optimizer

Audit .claude/rules/ and CLAUDE.md against what the codebase actually does.

imisic/claude-marketplace · 26 tokens

fp-yoohoo

Terminal-recall mode. Reference for fp-yoohoo, the plugin that brings the terminal window to the foreground when Claude Code stops and waits on a human: a permission prompt, a question dialog, a plan to approve. Explains what it hooks, which desktops it can raise a window on, how the already-focused guard works, and…

SlashyIsTaken/fp-pluginplaza · 161 tokens

career-portfolio

한국 신입 취준생·재직자를 위한 분야별 포트폴리오 구성과 프로젝트 기술서 작성 스킬입니다. "포트폴리오 만들어줘", "프로젝트 정리해줘", "노션 포트폴리오 1시간 만에"처럼 말하면 됩니다. 개발(GitHub·기술 블로그)/디자인(Figma·Behance)/마케팅/기획 분야별 + 검색되는 노션 포트폴리오 + 채용공고 맞춤형 1page 셀링 + 877건 노하우 기반 비중 배분을 지원합니다.

modu-ai/moai-cowork · 133 tokens

todos

This chat has a shared, live TODO plan — your tasks for the conversation, which the user also edits. Read this skill and reach for the todo tools whenever a request takes more than a couple of steps. It covers the plan model (group = task, items = its steps; loose items are the user's lane), how to work it: propose…

JetBrains/thinkrail · 127 tokens

meetings-cleanup

Manage old recordings — find large files, archive old meetings, delete processed originals. Use when the user says "clean up recordings", "how much space are meetings using", "delete old recordings", "archive meetings", "manage meeting storage", or asks about disk space from minutes.

flonat/flonat-research · 61 tokens