Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot official · Google

gws-script-push — Claude Code skill: what it does, how to install

Uploads local files to a Google Apps Script project. Use it when your changes are ready in a working directory and need to be pushed to the project.

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

What gws-script-push does

This skill runs gws script +push --script to upload a local directory to an Apps Script project. The --script flag is required, while --dir selects the script directory; without it, the current directory is used.

It handles .gs, .js, .html, and appsscript.json files. Hidden files and node_modules are skipped automatically. The command replaces every file in the target project, so confirm the action and check the Script Project ID before running it.

The gws binary and authentication described in gws-shared/SKILL.md are required. Install it for direct publishing from a local Apps Script directory; it does not fit partial file updates.

What it helps with

  • upload local files to an Apps Script project
  • push scripts from the current directory
  • select ./src as the upload directory
  • skip hidden files and node_modules
  • replace project files through a Script Project ID

Example prompts for the agent

  • Upload the current directory to the Apps Script project with ID `SCRIPT_ID`.
  • Push files from `./src` to project `SCRIPT_ID` with `gws script +push`.
  • Confirm that every project file will be replaced, then run `gws script +push --script SCRIPT_ID --dir ./src`.

How to install gws-script-push

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

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

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 orca-per-workspace-env stablyai Configures, reviews, and debugs Orca per-workspace environment recipes. Useful when provisioning disposable VMs, containers, SSH hosts, or cloud sandboxes. Claude Code CX Codex Cursor +1 12,100installs openai-whisper openclaw This skill lets your agent call the Whisper CLI to transcribe audio on your own machine. No API key needed. Claude Code CX Codex Cursor +1 7,100installs 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

Questions about gws-script-push

How do I install gws-script-push in Claude Code?

Run npx skills add googleworkspace/cli --skill gws-script-push -a claude-code. The skill is installed at ~/.claude/skills/gws-script-push/SKILL.md.

What does gws-script-push do?

It uploads local files to a Google Apps Script project with gws script +push --script . It replaces all files in the target project.

Which files does gws-script-push upload?

It supports .gs, .js, .html, and appsscript.json files. Hidden files and node_modules are skipped.

Source text

SKILL.md · Apache-2.0
---
name: gws-script-push
description: "Google Apps Script: Upload local files to an Apps Script project."
metadata:
  version: 0.22.5
  openclaw:
    category: "productivity"
    requires:
      bins:
        - gws
    cliHelp: "gws script +push --help"
---

# script +push

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

Upload local files to an Apps Script project

## Usage

```bash
gws script +push --script <ID>
```

## Flags

| Flag | Required | Default | Description |
|------|----------|---------|-------------|
| `--script` | ✓ | — | Script Project ID |
| `--dir` | — | — | Directory containing script files (defaults to current dir) |

## Examples

```bash
gws script +push --script SCRIPT_ID
gws script +push --script SCRIPT_ID --dir ./src
```

## Tips

- Supports .gs, .js, .html, and appsscript.json files.
- Skips hidden files and node_modules automatically.
- This replaces ALL files in the project.

> [!CAUTION]
> This is a **write** command — confirm with the user before executing.

## See Also

- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
- [gws-script](../gws-script/SKILL.md) — All manage google apps script projects commands

© googleworkspace · Apache-2.0 · googleworkspace/cli

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

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