Skip to main content
affpapa.org
RU EN
skill Claude Code CX Codex Cursor GitHub Copilot official · Google

gws-script — Claude Code skill for managing Apps Script projects

A skill that gives coding agents the gws CLI for Google Apps Script. Create projects, read code, check metrics and run scripts.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add googleworkspace/cli --skill gws-script -a claude-code
Open on GitHub

What gws-script does

The skill wraps the gws command, which talks to the Apps Script API. An agent can create empty script projects, fetch metadata and file contents, push updates and run scripts.

Resources covered: processes, projects and scripts. Project methods include create, get, getContent, getMetrics and updateContent, plus operations on deployments and versions. Before calling a method, inspect it with gws schema script.. to see required params and defaults.

Read ../gws-shared/SKILL.md first — it handles auth, global flags and security rules. If that file is missing, run gws generate-skills. The gws binary is a hard dependency; without it the skill does nothing.

What it helps with

  • create an empty Apps Script project
  • fetch content and metadata from a script
  • push local files into a project
  • check execution metrics and active users
  • run a script through the API

Example prompts for the agent

  • Create a new Apps Script project and return its ID
  • Show the content of my gws-script project
  • Upload files from ./src into the Apps Script project

How to install gws-script

1Skills CLI (Vercel)

npx skills add googleworkspace/cli --skill gws-script -a claude-code

2Manually: put the files in place

~/.claude/skills/gws-script/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gws-script/

From the same set95

The whole set →
gws-gmail official googleworkspace This skill hands your agent Gmail: send mail, read the inbox, reply in a thread. Useful when email work already runs through the gws CLI. Claude Code CX Codex Cursor +1 81,900installs gws-gmail-send official googleworkspace A skill that teaches your agent to send Gmail from the terminal: recipients, subject, body, attachments and drafts. Claude Code CX Codex Cursor +1 74,700installs gws-drive official googleworkspace This skill hands your agent Google Drive through the gws CLI: files, folders, shared drives, comments and access requests. Useful when docs move through code. Claude Code CX Codex Cursor +1 74,500installs gws-shared official googleworkspace This skill gives agents shared rules for gws CLI authentication, flags, and output formats. Use it when working with gws commands. Claude Code CX Codex Cursor +1 66,000installs gws-calendar official googleworkspace Manage Google Calendar events, access rules, and schedules through the gws CLI tool. Claude Code CX Codex Cursor +1 61,100installs gws-sheets official googleworkspace This skill lets an agent read and edit Google Sheets through the CLI. Use it when a coding workflow needs spreadsheet data or table updates. Claude Code CX Codex Cursor +1 58,800installs gws-docs official googleworkspace This skill lets an agent read and update Google Docs through gws. Use it when document changes should happen from an agent chat. Claude Code CX Codex Cursor +1 58,300installs gws-sheets-read official googleworkspace Reads cell values and sheets from Google Spreadsheets via CLI. Useful when an agent needs spreadsheet data without risk of altering it. Claude Code CX Codex Cursor +1 50,600installs

Similar

marketing-loops coreyhaines31 Sets up a recurring marketing loop an agent runs on a cadence, with a trigger, bounded steps, a self-check and a stop condition. Useful when a task repeats weekly. Claude Code CX Codex Cursor +1 47,200installs gog openclaw Guides an agent using the gog CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs. Use it when Google Workspace tasks need to run from a terminal. Claude Code CX Codex Cursor +1 8,500installs tmux openclaw Lets an agent work with live tmux sessions: read pane output, send keys and text, wait for a prompt line to show up. Claude Code CX Codex Cursor +1 8,400installs find-skills vercel-labs Discovers and installs agent skills from skills.sh directly inside your coding assistant. Handy when you need domain-specific workflows for a project. Claude Code CX Codex Cursor +1 4,000,000installs grill-me Matt Pocock grill-me interviews you about a plan or design to expose gaps and sharpen decisions. Use it before implementation starts. Claude Code 1,424,476installs grill-with-docs Matt Pocock This skill interviews you about a plan or design and creates ADRs and a glossary along the way. Use it when decisions need sharper definition. Claude Code 1,219,756installs handoff Matt Pocock Creates a handoff document from the current conversation so another agent can continue the work. Use it when a task moves to a new session or agent. Claude Code 1,038,491installs grilling Matt Pocock Stress-test a plan, decision, or idea through structured rounds of questions. Use it when you need to expose assumptions before acting. Claude Code 979,543installs

Questions about gws-script

How do I install gws-script in Claude Code?

Run npx skills add googleworkspace/cli --skill gws-script -a claude-code. The skill lands in ~/.claude/skills/gws-script/SKILL.md.

What does gws-script do?

It gives an agent the gws command for managing Apps Script projects: creating them, reading and updating content, checking metrics and running scripts.

What do I need before using this skill?

The gws binary and the shared skill file at ../gws-shared/SKILL.md with auth setup. If that file is absent, generate it with gws generate-skills.

Source text

SKILL.md · Apache-2.0 
---
name: gws-script
description: "Manage Google Apps Script projects."
metadata:
  version: 0.22.5
  openclaw:
    category: "productivity"
    requires:
      bins:
        - gws
    cliHelp: "gws script --help"
---

# script (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 script <resource> <method> [flags]
```

## Helper Commands

| Command | Description |
|---------|-------------|
| [`+push`](../gws-script-push/SKILL.md) | 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:

```bash
# 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.

© googleworkspace · Apache-2.0 · googleworkspace/cli

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor