How to use the Apps Script File Push agent skill

What is an agent skill and what does this one do?

An agent skill is a folder containing a SKILL.md file that gives an AI agent instructions for one specific task. This skill covers one task: pushing code from your computer to Google Apps Script. Once installed, when you ask the agent to push code to Apps Script, it knows the correct gws command and flags to use.

The skill reads local files with the extensions .gs, .js, .html and appsscript.json from a folder and uploads them to an Apps Script project identified by its Script Project ID.

• Works on files: .gs, .js, .html and appsscript.json.
• Targets one project by its Script Project ID.
• The upload replaces all files in the target project, so it is a destructive write operation.

What do you need before installing?

The skill cannot work without three things: the gws command-line tool (Google Workspace CLI), Google authentication configured for gws, and an Apps Script Project ID. The source says authentication is described in the shared gws-shared skill, which the agent reads for setup details.

If the gws-shared skill is missing, the source says to run gws generate-skills to create it.

• The gws command-line tool (Google Workspace CLI) installed.
• Google authentication configured for gws, as described in the gws-shared skill.
• The Script Project ID of the Apps Script project you want to update.

How do you install the skill?

Download the ZIP file from this page and unzip it. You can install it in one of two places. For all your projects, unzip it into ~/.claude/skills/. For a single project, unzip it into that project's .claude/skills/ folder.

If you use the Claude apps instead, you can upload the skill under Settings → Capabilities → Skills.

• Personal install: ~/.claude/skills/
• Project install: .claude/skills/ inside your project folder
• Claude apps: Settings → Capabilities → Skills, then upload

How do you trigger the skill with a natural request?

You do not need to type the command yourself. Ask the agent in plain language to push code to Apps Script, and name the project and folder if you can. The agent should then pick this skill and prepare the gws command.

Because the push is a write command, the skill instructs the agent to confirm with you before running it. Check the command and project ID the agent proposes before you approve.

• "Push the files in ./src to my Apps Script project SCRIPT_ID."
• "Upload my local Apps Script code to project SCRIPT_ID."
• "Deploy my Apps Script changes from this folder."

What commands does the skill use?

The skill's basic usage is shown below. The --script flag is required and takes the Script Project ID. The --dir flag is optional; if you leave it out, the current directory is used.

The source lists two examples: one using the current directory and one pointing at ./src. Both are shown below.

• --script (required): Script Project ID.
• --dir (optional): directory containing script files; defaults to the current directory.
• Hidden files and node_modules are skipped automatically.

What should you check for safety?

This skill runs scripts and uses the network. Its main risk is not a bad download but an overwrite: the upload replaces every file in the target project. If the online editor holds changes that are not saved in your local folder, those changes will be lost.

Before approving a push, confirm the Script Project ID is the one you intend, the --dir folder contains the complete set of files you want, and nobody has edited the online project in a way you have not copied locally. Also read the shared gws-shared skill for auth and security rules.

• Confirm the Script Project ID before running.
• Make sure the local folder holds every file the project should have.
• Copy any online-only edits to your local folder first.
• Keep your code in a version-controlled repository so you can recover earlier versions.

What tips help you avoid problems?

Keep the local folder as the single source of truth for the project. Because the push replaces everything, partial folders are a common cause of lost files. The skill is also not suited to editing one file at a time.

• Use --dir when your code lives in a subfolder such as ./src.
• Only .gs, .js, .html and appsscript.json files are uploaded.
• Use this skill only if you want the whole project replaced, not a single-file edit.