Skip to content

fix(skills): treat shared guidance as reference#862

Open
initiallyqq wants to merge 1 commit into
googleworkspace:mainfrom
initiallyqq:fix-agent-skill-shared-reference-849
Open

fix(skills): treat shared guidance as reference#862
initiallyqq wants to merge 1 commit into
googleworkspace:mainfrom
initiallyqq:fix-agent-skill-shared-reference-849

Conversation

@initiallyqq

Copy link
Copy Markdown

Summary

  • Reword generated service/helper skills so gws-shared is reference material rather than a required startup procedure.
  • Add agent/sandbox guidance to gws-shared that discourages proactive auth, setup, cache, and generate-skills commands.
  • Sync the checked-in generated skills and add a patch changeset.

Fixes #849

Tests

  • rustfmt.exe --edition 2021 --check crates/google-workspace-cli/src/generate_skills.rs
  • git diff --check
  • cargo test -p google-workspace-cli generate_skills could not complete locally because the Windows MSVC toolchain cannot find Visual Studio link.exe in this environment.

@changeset-bot

changeset-bot Bot commented Jul 3, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 2f734c5

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
@googleworkspace/cli Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@google-cla

google-cla Bot commented Jul 3, 2026

Copy link
Copy Markdown

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

@gemini-code-assist

Copy link
Copy Markdown
Contributor

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request refines the onboarding and usage documentation for the gws CLI tools. By reclassifying gws-shared documentation from a 'prerequisite' to 'reference material', it prevents unnecessary automated setup procedures in agent and sandbox environments, while still providing essential guidance for users when explicitly needed.

Highlights

  • Documentation Update: Updated generated service and helper skills to treat gws-shared as reference material rather than a mandatory startup prerequisite.
  • Agent Guidance: Added specific guidance for agent and sandbox environments to gws-shared to discourage unnecessary proactive setup commands.
  • Sync Changes: Synchronized all checked-in generated skills and added a changeset to reflect the updated documentation standards.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize the Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counterproductive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

Footnotes

  1. Review the Generative AI Prohibited Use Policy, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the generated skill documentation to clarify that gws-shared should be treated as reference material rather than a startup checklist for agent and sandbox environments. It replaces the previous 'PREREQUISITE' warning with a 'REFERENCE' note across all skill markdown files, introduces a new 'Agent and Sandbox Use' section, and updates the generator code and tests accordingly. No review comments were provided, so I have no feedback to offer.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Agent skills: gws-gmail prereq on gws-shared causes unnecessary ceremony in agent environments

2 participants