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

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

Interacts with Google Forms via the gws CLI. Helps automate form creation, schema checks, and response retrieval inside agent workflows.

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

What gws-forms does

This skill executes Google Forms operations through the gws command-line utility. The agent can generate empty forms, inspect existing definitions with get, and push modifications with batchUpdate. Reading respondent data happens through the responses and watches endpoints. New forms only accept a title during creation. Questions must be added through a separate update call.

The skill requires the gws binary. Before running commands, configure credentials or execute gws generate-skills to generate shared prerequisites. You can inspect parameter schemas using gws schema. Legacy forms do not support publish settings updates because they lack the required field.

Install this skill if you build surveys and inspect submissions through workspace automation. Manual browser edits do not need this utility.

What it helps with

  • create a new form with a title using gws forms create
  • add form questions and sections using batchUpdate
  • retrieve form metadata and schema definitions with get
  • read respondent answers from the responses endpoint
  • inspect required parameters and flags with gws schema

Example prompts for the agent

  • Create a new feedback form titled Team Survey using gws
  • Inspect the questions on the existing form with gws forms get
  • Show parameter schema for batchUpdate using gws schema

How to install gws-forms

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

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

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

free-tools coreyhaines31 Helps you decide whether a free tool is worth building for leads and links, and how to scope it. Claude Code CX Codex Cursor +1 73,400installs marketing-plan coreyhaines31 Generates an AARRR-structured 12-month marketing plan with an audit score and a 90-day roadmap. Outputs a single Markdown document ready for Notion. Claude Code CX Codex Cursor +1 67,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 teach Matt Pocock Turns the current directory into a learning workspace and keeps progress across sessions. Use it when learning needs to support a concrete goal in your project. Claude Code 862,247installs

Questions about gws-forms

How do I install gws-forms in Claude Code?

Run npx skills add googleworkspace/cli --skill gws-forms -a claude-code. This copies the skill instructions into your configuration.

What does the gws-forms skill do?

It enables an agent to run gws forms commands to create forms, update questions, and inspect survey responses.

What prerequisites are needed before using it?

You need the gws binary and valid credentials. If shared skill files are missing, run gws generate-skills.

Source text

SKILL.md · Apache-2.0 
---
name: gws-forms
description: "Read and write Google Forms."
metadata:
  version: 0.22.5
  openclaw:
    category: "productivity"
    requires:
      bins:
        - gws
    cliHelp: "gws forms --help"
---

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

## API Resources

### forms

  - `batchUpdate` — Change the form with a batch of updates.
  - `create` — Create a new form using the title given in the provided form message in the request. *Important:* Only the form.info.title and form.info.document_title fields are copied to the new form. All other fields including the form description, items and settings are disallowed. To create a new form and add items, you must first call forms.create to create an empty form with a title and (optional) document title, and then call forms.update to add the items.
  - `get` — Get a form.
  - `setPublishSettings` — Updates the publish settings of a form. Legacy forms aren't supported because they don't have the `publish_settings` field.
  - `responses` — Operations on the 'responses' resource
  - `watches` — Operations on the 'watches' resource

## Discovering Commands

Before calling any API method, inspect it:

```bash
# Browse resources and methods
gws forms --help

# Inspect a method's required params, types, and defaults
gws schema forms.<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