gws-slides — Claude Code skill: what it does, how to install
Read and write Google Slides presentations directly from your CLI agent. Helpful when you need to inspect existing decks or generate slides from your data.
npx skills add googleworkspace/cli --skill gws-slides -a claude-codeWhat gws-slides does
This skill gives your agent direct access to Google Slides through the gws CLI tool. It supports core methods on the presentations resource, including create to generate blank decks, get to read the latest slide tree, and batchUpdate to send edit instructions. Slide-level operations are handled under the pages resource.
Every batchUpdate request is validated before execution. If a single update in the list is invalid, the entire operation fails without applying changes. To avoid syntax errors, you can run gws schema to inspect required parameters, types, and defaults before calling any method. The skill requires the gws binary and shared credentials configured in gws-shared.
Install this skill if your workflow involves generating or reading presentations from the console. If you only need to change a slide layout occasionally, the standard browser interface is much simpler.
What it helps with
- create blank Google Slides presentations with a chosen title
- fetch the latest presentation structure using its ID
- apply atomic batches of slide updates via batchUpdate
- inspect method schemas and parameter flags before calling the API
Example prompts for the agent
- Create a new Google Slides presentation titled Quarterly Review
- Inspect the schema for the batchUpdate method in Google Slides
- Fetch presentation details using gws slides presentations get
How to install gws-slides
1Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-slides -a claude-code2Manually: put the files in place
~/.claude/skills/gws-slides/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gws-slides/
1Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-slides -a codex2Manually: put the files in place
.agents/skills/gws-slides/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-slides -a cursor2Manually: put the files in place
.cursor/skills/gws-slides/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install googleworkspace/cli gws-slides2Manually: put the files in place
.github/skills/gws-slides/SKILL.md1Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-slides -a gemini-cli2Platform CLI
gemini skills install https://github.com/googleworkspace/cli --path skills/gws-slidesManually: put the files in place
.devin/skills/gws-slides/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-slides -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set95
The whole set →Similar
Questions about gws-slides
How do I install gws-slides in Claude Code?
Install the skill by running npx skills add googleworkspace/cli --skill gws-slides -a claude-code. You also need the gws binary available in your system path.
What does the gws-slides skill do?
It enables CLI agents to create, inspect, and update Google Slides presentations through gws commands. The tool supports batch edits, presentation creation, and schema inspection.
What prerequisites are needed before using this skill?
You must have the gws binary installed and authentication set up via SKILL.md in gws-shared. If the shared configuration is missing, generate it with gws generate-skills.
Source text
SKILL.md · Apache-2.0
---
name: gws-slides
description: "Google Slides: Read and write presentations."
metadata:
version: 0.22.5
openclaw:
category: "productivity"
requires:
bins:
- gws
cliHelp: "gws slides --help"
---
# slides (v1)
> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
```bash
gws slides <resource> <method> [flags]
```
## API Resources
### presentations
- `batchUpdate` — Applies one or more updates to the presentation. Each request is validated before being applied. If any request is not valid, then the entire request will fail and nothing will be applied. Some requests have replies to give you some information about how they are applied. Other requests do not need to return information; these each return an empty reply. The order of replies matches that of the requests.
- `create` — Creates a blank presentation using the title given in the request. If a `presentationId` is provided, it is used as the ID of the new presentation. Otherwise, a new ID is generated. Other fields in the request, including any provided content, are ignored. Returns the created presentation.
- `get` — Gets the latest version of the specified presentation.
- `pages` — Operations on the 'pages' resource
## Discovering Commands
Before calling any API method, inspect it:
```bash
# Browse resources and methods
gws slides --help
# Inspect a method's required params, types, and defaults
gws schema slides.<resource>.<method>
```
Use `gws schema` output to build your `--params` and `--json` flags.
© googleworkspace · Apache-2.0 · googleworkspace/cli