Skip to content
Get packs

Google Apps Script Manager

Lets an agent list, create, read, update and run Google Apps Script projects via the gws CLI.

Source Download skill
Repository
googleworkspace/cli
Stars
32,059
Licence
Apache-2.0
Files
1 file

What it does

This skill teaches an AI agent how to use the gws command-line tool to work with Google Apps Script projects, the small automation programs that run inside Google Workspace (such as Sheets, Docs or Gmail). Once installed, the agent knows which commands exist for listing processes, creating projects, reading or overwriting a project's code, viewing metrics, and running scripts, and how to look up required parameters before calling them. It also points to a helper command for uploading local files to a project.

Great for

  • Developers who maintain Apps Script automations and want an agent to read or update project code
  • Workspace administrators who want to review script processes or metrics across projects
  • People already using the gws CLI who want an agent to drive it correctly

Skip it if

  • Users who do not have the gws tool installed and authenticated, since the skill only describes commands and cannot work without it
  • Anyone wanting to overwrite a live script casually: updateContent clears all existing files in the project and replaces them, so a mistake can destroy code
  • Situations needing a script run against production data without review, because the run method executes code with the account's Google permissions

Try asking

  • “List the recent processes run by my account and tell me which ones failed”
  • “Create a new empty Apps Script project called Invoice Helper”
  • “Show me the code files in my script project with ID abc123”
  • “Push my local Apps Script files in ./src to the project”
Step-by-step guide: how to use Google Apps Script ManagerInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the Apache-2.0 licence and an attribution note.

    gws-script.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip gws-script.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip gws-script.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Run the schema inspection command for a method before calling it so parameters are correct
  • Back up project content with getContent before using updateContent or +push, since existing files are cleared
  • Review the account and scopes gws uses before allowing the agent to run scripts

What's inside

  • SKILL.md

Redistributed unmodified from googleworkspace/cli under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.