gws-slides

Read and write Google Slides presentations through the gws CLI.

Updated Nov 9, 2023
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill gws-slides-oresttokovenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-slides
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/gws-slides
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill gws-slides-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It lets you create, read, and update Google Slides presentations programmatically from the command line, removing the need to manually edit decks through the Google Slides web interface. ## Core Features & Use Cases - Presentation Management: Create blank presentations with a given title and fetch the latest version of any existing presentation. - Batch Updates: Apply multiple validated edits to a presentation atomically, so partial changes are never committed. - Schema Discovery: Inspect resources, methods, and parameters with gws schema before building API calls. - Use Case: Generate a weekly status deck by creating a presentation, then applying batch updates to insert slides and text, all from a script. ## Quick Start Ask the assistant to create a new Google Slides presentation titled "Q3 Review" and then fetch its contents using the gws slides commands.

Frequently Asked Questions about gws-slides

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Google Slides presentation from the command line?

Use the gws slides presentations create method with a title in the request body. The API returns the created presentation, generating a new ID unless you provide a presentationId.

How do I update multiple slides in a Google Slides presentation at once?

Use the presentations batchUpdate method, which applies a list of update requests atomically. If any request is invalid, the entire batch fails and nothing is applied.

How do I find the required parameters for a Google Slides API method?

Run gws schema slides.<resource>.<method> to inspect required parameters, types, and defaults. Use that output to build the --params and --json flags for your call.

What do I need before using the gws slides commands?

You need the gws binary installed and the gws-shared skill available for authentication, global flags, and security rules. If it is missing, run gws generate-skills to create it.

Why did my Google Slides batchUpdate request fail completely?

batchUpdate validates every request before applying any of them, so one invalid request causes the entire batch to fail with no changes applied. Inspect each request against the schema and fix the invalid entry.