Skip to content
Get packs

Apps Script File Push

Upload local code files to a Google Apps Script project using the gws CLI, replacing its contents.

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 to use the gws command-line tool to upload local files (.gs, .js, .html and appsscript.json) from a folder into a Google Apps Script project, identified by its Script Project ID. Once installed, when asked to push code to Apps Script, the agent knows the correct command and flags. Importantly, the upload replaces all files in the target project, so it is a destructive write operation.

Great for

  • Developers who keep Google Apps Script code in a local repository and deploy it from the terminal
  • Teams automating Apps Script updates as part of a build or release workflow
  • Users already set up with the gws CLI and Google authentication

Skip it if

  • Anyone who has not set up gws and Google authentication, since the skill cannot work without them
  • Projects where the online editor holds code not saved locally, because the push would overwrite it and lose those changes
  • Users who only want to read or edit a single file, since this command replaces the whole project

Try asking

  • “Push my local ./src folder to my Apps Script project with ID abc123”
  • “Upload the scripts in this directory to Apps Script, confirming first”
  • “Sync my appsscript.json and .gs files to the script project”
Step-by-step guide: how to use Apps Script File PushInstall, 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-push.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

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

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip gws-script-push.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

  • Always confirm the Script Project ID and local directory before running, because the push overwrites every file in the remote project.
  • Back up or version-control the existing Apps Script project first if it may contain changes not stored locally.
  • Use --dir to point at a specific folder such as ./src rather than relying on the current directory.

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.