Skip to content
Skillpedia
PT
General coding32k · #6281

gws-script

Helps your agent manage Google Apps Script projects. It allows for automating tasks within the Google ecosystem.

What it does

This command helps manage Google Apps Script projects. You can create new projects, view information about them, get or update code, and even see usage metrics.

When to use it

  • ✓When you want to create a new script from scratch.
  • ✓When you need to see the code of an existing script.
  • ✓To check how many people are using your script.

Example of what to ask your AI

“Create a new script project named 'My First Script'.”

Want more? Open the sections below.

How to use

The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.

Skill link

https://github.com/googleworkspace/cli/blob/main/skills/gws-script/SKILL.md

Ready-to-paste message

Use this skill to help me: https://github.com/googleworkspace/cli/blob/main/skills/gws-script/SKILL.md Read the SKILL.md file at that link and follow its instructions for my task.
View on GitHub ↗Raw file
How it works

You specify the action you want to perform (like 'create project' or 'view code') and for which project. The tool communicates with Google to get the job done.

Installation

Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.

In the terminal (Claude Code, Codex, Cursor), in your project folder:

npx skills add googleworkspace/cli --skill gws-script

Or download just the file:

curl -L https://raw.githubusercontent.com/googleworkspace/cli/main/skills/gws-script/SKILL.md -o SKILL.md
Technical content (original SKILL.md)

Original text by the author, straight from GitHub.

script (v1)

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

gws script <resource> <method> [flags]

Helper Commands

Command Description
+push Upload local files to an Apps Script project

API Resources

processes

  • list — List information about processes made by or on behalf of a user, such as process type and current status.
  • listScriptProcesses — List information about a script's executed processes, such as process type and current status.

projects

  • create — Creates a new, empty script project with no script files and a base manifest file.
  • get — Gets a script project's metadata.
  • getContent — Gets the content of the script project, including the code source and metadata for each script file.
  • getMetrics — Get metrics data for scripts, such as number of executions and active users.
  • updateContent — Updates the content of the specified script project. This content is stored as the HEAD version, and is used when the script is executed as a trigger, in the script editor, in add-on preview mode, or as a web app or Apps Script API in development mode. This clears all the existing files in the project.
  • deployments — Operations on the 'deployments' resource
  • versions — Operations on the 'versions' resource

scripts

  • run —

Discovering Commands

Before calling any API method, inspect it:

# Browse resources and methods
gws script --help

# Inspect a method's required params, types, and defaults
gws schema script.<resource>.<method>

Use gws schema output to build your --params and --json flags.

FAQ

What is Google Apps Script?

It's a way to create small programs (scripts) that automate tasks within Google Workspace (Gmail, Sheets, Drive, etc.).

What do 'resource' and 'method' mean?

'Resource' is like a type of thing you can manage (e.g., 'projects'). 'Method' is the action you want to perform on that thing (e.g., 'create' or 'get').

What is `gws schema`?

It's a command that shows the specific details needed to use a particular function, like what information you need to provide.

Details

Original description by the author

Manage Google Apps Script projects.

repo: googleworkspace/cli

Popularity

GitHub stars
32k
Ranking position
#6281
License
Apache-2.0
Updated
10/6/2026

Is this skill useful?

0

Sign in to vote.

Comments

  • …

More skills from this repository

Analysis & spreadsheets32k

gws-admin-reports

Helps your agent get activity reports from Google Workspace. It collects audit and usage data.

googleworkspace/cli

Email & messaging32k

gws-calendar-agenda

Helps your agent see upcoming events across all calendars. It's useful for organizing your schedule and knowing what's coming up.

googleworkspace/cli

Email & messaging32k

gws-calendar-insert

Lets your agent create new events in Google Calendar. It's useful for scheduling appointments and meetings.

googleworkspace/cli

Email & messaging32k

gws-calendar

Allows your agent to manage calendars and events. It's useful for organizing your life and work.

googleworkspace/cli

Similar skills

General coding280k

benchmark-optimization-loop

Has your agent improve something's speed in a measured way. It tests multiple versions and chooses the fastest one that still works correctly.

affaan-m/ECC

General coding280k

change-impact

Helps your agent analyze the impact of code changes before making them. It compares the planned vs. actual results afterward, covering paths, data, tests, and documentation. Useful for risky or system-wide changes.

affaan-m/ECC

General coding280k

click-path-audit

Lets your agent trace all user buttons and interactions to find bugs. It finds issues where functions seem to work alone but fail together. Useful when bugs persist even after debugging.

affaan-m/ECC