// Always consult before any Google Workspace operation via the `gws` CLI: sending or reading Gmail and triaging the inbox, Calendar events and agendas, Docs, Drive files and folders, Sheets, Slides, Forms, and adding, listing, or completing Tasks, reminders, and to-dos. Routes to per-service reference files for auth, flags, and command syntax.
Extract design DNA from a website into a reusable specification with steerable variables
YOU MUST use this skill for anything involving past Claude Code conversations in ~/.claude/projects/: when the conversation starts with 'this session is being continued from a previous conversation that ran out of context', or to recover context from a previous conversation, or to discover/catalog which conversations exist (by date, project, message count), or to search and read past conversation logs. One entry point for cataloging, searching, and rendering Claude Code JSONL transcripts.
Always consult before drafting any human-facing prose: messages, emails, pull request descriptions, GitHub issues, Reddit posts, agendas, documents, code review comments, bug reports, release notes, or any other text a person will read. Enforces direct, warm, unfilled tone; removes AI tells; runs a self-audit before delivery. Skip ONLY when the task is operational (calling an API, running a CLI) rather than composing prose.
Always consult before opening, reading, navigating, scraping, fetching, or screenshotting any URL or webpage. Handles browser automation, JavaScript-rendered content, form filling, dynamic page interaction, and structured extraction in ways native HTTP fetch cannot. Skip ONLY for raw-text or JSON endpoints where a single WebFetch suffices.
Always consult before writing, scoring, or rewriting any SKILL.md description field. Provides the rubric, template, and apply script that handle YAML safety and produce a backup on each write.
This skill should be used when the user asks to "QA changes", "verify this works", "test the build", "check if this runs", "validate changes in tmux", or wants end-to-end verification of code changes by running builds, tests, and applications in tmux.
| name | gws |
| description | Always consult before any Google Workspace operation via the `gws` CLI: sending or reading Gmail and triaging the inbox, Calendar events and agendas, Docs, Drive files and folders, Sheets, Slides, Forms, and adding, listing, or completing Tasks, reminders, and to-dos. Routes to per-service reference files for auth, flags, and command syntax. |
| metadata | {"category":"productivity","requires":{"bins":["gws"]}} |
One entry point for Google Workspace through the gws command-line tool. This file is a router: find your task in the table, then read the matching reference file for full command syntax. Each reference is the upstream generated skill, kept current by gws generate-skills.
Read references/gws-shared/SKILL.md for authentication (gws auth login), global flags (--format, --dry-run, --sanitize), method flags (--params, --json, --page-all), and shell-quoting rules. Every service below assumes it.
Confirm with the user before any write or delete, and prefer --dry-run to validate first.
gws <service> <resource> [sub-resource] <method> [flags]
Inspect any command before calling it:
gws <service> --help # browse resources and methods
gws schema <service>.<resource>.<method> # required params, types, defaults
| Task involves | Reference | Shortcut helpers |
|---|---|---|
| Calendar: events, scheduling, agendas | gws-calendar | +insert, +agenda |
| Gmail: messages, threads, labels, drafts | gws-gmail | +send, +read, +reply, +reply-all, +forward, +triage, +watch |
| Docs: read and write documents | gws-docs | +write |
| Drive: files, folders, shared drives | gws-drive | +upload |
| Forms: read and edit forms, responses | gws-forms | — |
| Sheets: read and write spreadsheets | gws-sheets | +append, +read |
| Slides: build and edit presentations | gws-slides | — |
| Tasks: task lists, reminders, to-dos | gws-tasks | — |
The reference files cross-link to each other and to gws-shared with relative paths. Those resolve inside references/ because the whole upstream skills/ tree is mounted there.
references/ is a symlink to the upstream googleworkspace/cli checkout's skills/ directory. Re-run gws generate-skills in that repo to refresh every reference at once.references/gws-<service>/SKILL.md.