- Installs
- 30.2K
- Last 24h
- +40
- Trending rank
- #3910
- Security
- Pass
Install
Works with every agent the skills CLI supports.
npx skills add https://googleworkspace/cli --skill gws-classroom- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads gws-classroom automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
Security audits
Independent scans of the skill's instructions and bundled files.
SKILL.md
The instructions your agent reads when the skill is triggered.
classroom (v1)
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
gws classroom <resource> <method> [flags]
API Resources
courses
create— Creates a course. The user specified inownerIdis the owner of the created course and added as a teacher. A non-admin requesting user can only create a course with themselves as the owner. Domain admins can create courses owned by any user within their domain. This method returns the following error codes: *PERMISSION_DENIEDif the requesting user is not permitted to create courses or for access errors. *NOT_FOUNDif the primary teacher is not a valid user.delete— Deletes a course. This method returns the following error codes: *PERMISSION_DENIEDif the requesting user is not permitted to delete the requested course or for access errors. *NOT_FOUNDif no course exists with the requested ID.get— Returns a course. This method returns the following error codes: *PERMISSION_DENIEDif the requesting user is not permitted to access the requested course or for access errors. *NOT_FOUNDif no course exists with the requested ID.getGradingPeriodSettings— Returns the grading period settings in a course. This method returns the following error codes: *PERMISSION_DENIEDif the requesting user isn't permitted to access the grading period settings in the requested course or for access errors. *NOT_FOUNDif the requested course does not exist.list— Returns a list of courses that the requesting user is permitted to view, restricted to those that match the request. Returned courses are ordered by creation time, with the most recently created coming first. This method returns the following error codes: *PERMISSION_DENIEDfor access errors. *INVALID_ARGUMENTif the query argument is malformed. *NOT_FOUNDif any users specified in the query arguments do not exist.patch— Updates one or more fields in a course. This method returns the following error codes: *PERMISSION_DENIEDif the requesting user is not permitted to modify the requested course or for access errors. *NOT_FOUNDif no course exists with the requested ID. *INVALID_ARGUMENTif invalid fields are specified in the update mask or if no update mask is supplied.update— Updates a course. This method returns the following error codes: *PERMISSION_DENIEDif the requesting user is not permitted to modify the requested course or for access errors. *NOT_FOUNDif no course exists with the requested ID. *FAILED_PRECONDITIONfor the following request errors: * CourseNotModifiable * CourseTitleCannotContainUrlupdateGradingPeriodSettings— Updates grading period settings of a course. Individual grading periods can be added, removed, or modified using this method. The requesting user and course owner must be eligible to modify Grading Periods. For details, see licensing requirements.aliases— Operations on the 'aliases' resourceannouncements— Operations on the 'announcements' resourcecourseWork— Operations on the 'courseWork' resourcecourseWorkMaterials— Operations on the 'courseWorkMaterials' resourceposts— Operations on the 'posts' resourcestudentGroups— Operations on the 'studentGroups' resourcestudents— Operations on the 'students' resourceteachers— Operations on the 'teachers' resourcetopics— Operations on the 'topics' resource
invitations
accept— Accepts an invitation, removing it and adding the invited user to the teachers or students (as appropriate) of the specified course. Only the invited user may accept an invitation. This method returns the following error codes: *PERMISSION_DENIEDif the requesting user is not permitted to accept the requested invitation or for access errors.create— Creates an invitation. Only one invitation for a user and course may exist at a time. Delete and re-create an invitation to make changes. This method returns the following error codes: *PERMISSION_DENIEDif the requesting user is not permitted to create invitations for this course or for access errors. *NOT_FOUNDif the course or the user does not exist. *FAILED_PRECONDITION: * if the requested user's account is disabled.delete— Deletes an invitation. This method returns the following error codes: *PERMISSION_DENIEDif the requesting user is not permitted to delete the requested invitation or for access errors. *NOT_FOUNDif no invitation exists with the requested ID.get— Returns an invitation. This method returns the following error codes: *PERMISSION_DENIEDif the requesting user is not permitted to view the requested invitation or for access errors. *NOT_FOUNDif no invitation exists with the requested ID.list— Returns a list of invitations that the requesting user is permitted to view, restricted to those that match the list request. Note: At least one ofuser_idorcourse_idmust be supplied. Both fields can be supplied. This method returns the following error codes: *PERMISSION_DENIEDfor access errors.
registrations
create— Creates aRegistration, causing Classroom to start sending notifications from the providedfeedto the destination provided incloudPubSubTopic. Returns the createdRegistration. Currently, this will be the same as the argument, but with server-assigned fields such asexpiry_timeandidfilled in. Note that any value specified for theexpiry_timeoridfields will be ignored.delete— Deletes aRegistration, causing Classroom to stop sending notifications for thatRegistration.
userProfiles
get— Returns a user profile. This method returns the following error codes: *PERMISSION_DENIEDif the requesting user is not permitted to access this user profile, if no profile exists with the requested ID, or for access errors.guardianInvitations— Operations on the 'guardianInvitations' resourceguardians— Operations on the 'guardians' resource
Discovering Commands
Before calling any API method, inspect it:
# Browse resources and methods
gws classroom --help
# Inspect a method's required params, types, and defaults
gws schema classroom.<resource>.<method>
Use gws schema output to build your --params and --json flags.
FAQ
What does the gws-classroom skill do?
Google Classroom: Manage classes, rosters, and coursework.
How do I install gws-classroom?
Run npx skills add https://googleworkspace/cli --skill gws-classroom in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/gws-classroom/ (personal) or .claude/skills/gws-classroom/ (project).
Which AI agents can use gws-classroom?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is gws-classroom safe to install?
Security partners have reviewed it: Gen Agent Trust Hub passed; Socket passed; Snyk passed; Runlayer passed; ZeroLeaks passed. As with any skill, read the SKILL.md and bundled scripts before installing.
Who maintains gws-classroom?
It is published by googleworkspace/cli in googleworkspace/cli. It has 30,224 recorded installs.
More from googleworkspace/cli
gws-gmail
googleworkspace/cli
Gmail: Send, read, and manage email.
gws-shared
googleworkspace/cli
gws CLI: Shared patterns for authentication, global flags, and output formatting.
gws-calendar
googleworkspace/cli
Google Calendar: Manage calendars and events.
Popular other skills
hyperframes-cli
heygen-com/hyperframes
The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.
triage
mattpocock/skills
Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.
ask-matt
mattpocock/skills
Ask which skill or flow fits your situation. A router over the skills in this repo.
to-questionnaire
mattpocock/skills
Turn a decision you can't fully answer into a questionnaire for someone else to fill in.
loop-me
mattpocock/skills
Grill me about specs for the workflows I want to build, within this workspace.