Read and write Google Forms.
The gws-forms skill provides seamless interaction with Google Forms, enabling users to programmatically read and write forms. It simplifies the process of managing forms by allowing batch updates, creation of new forms, retrieval of form data, and modification of publish settings. By exposing these capabilities via command-line operations, it addresses the need for automation in workflows that involve repetitive form management tasks, such as collecting survey responses or updating questionnaire templates across multiple forms efficiently.
Key features of gws-forms include the ability to batch update forms, create new forms with specified titles, retrieve existing form details, adjust publishing settings, and manage responses and watches. The skill supports structured inspection of API resources and methods, allowing users to understand required parameters, types, and defaults before execution. It integrates with the gws CLI and requires the gws binary, making it suitable for productivity-focused environments where command-line interfaces are preferred. Legacy forms without publish settings are not supported, ensuring that all operations align with current Google Forms API capabilities.
This skill is ideal for professionals who need to automate form management tasks, such as data analysts, survey administrators, or developers building internal tools that rely on Google Forms data. It supports workflows where multiple forms need to be created, updated, or monitored regularly, reducing manual overhead and ensuring consistency. Target users are expected to have familiarity with CLI operations and basic understanding of form structures, enabling them to leverage batch updates and structured responses effectively.
You can create a new form using the 'create' method by specifying the title (and optionally the document title). Note that only these fields are copied; to add items, you must follow up with the 'update' method.
Only forms with the 'publish_settings' field are supported. Legacy forms without this field cannot be updated using setPublishSettings.
Yes, you must first have the shared gws configuration for authentication, global flags, and security rules. If it's missing, run 'gws generate-skills' to create it.
Yes, you can browse available resources and methods using 'gws forms --help' and inspect method parameters, types, and defaults with 'gws schema forms.<resource>.<method>'.
The skill requires the gws binary to be installed and accessible in your environment.
Quick Setup:
.claude/skills/Repository
googleworkspace/cli