hermes - 💡(How to fix) Fix Bundled google-workspace skill: SKILL.md documents `--services` / `--format` setup.py flags that don't exist (auth flow fails) [1 pull requests]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

The bundled productivity/google-workspace skill's SKILL.md instructs the agent to run the OAuth setup helper with --services and --format flags, but scripts/setup.py defines neither. Following the documented auth flow therefore fails with an argparse unrecognized arguments error, so a fresh user can't complete Google Workspace OAuth by following the skill as written.

Confirmed on current main (also seen on v0.15.1).

Error Message

$ python skills/productivity/google-workspace/scripts/setup.py --auth-url --services email,calendar --format json usage: setup.py [-h] ... setup.py: error: unrecognized arguments: --services email,calendar --format json

Root Cause

The bundled productivity/google-workspace skill's SKILL.md instructs the agent to run the OAuth setup helper with --services and --format flags, but scripts/setup.py defines neither. Following the documented auth flow therefore fails with an argparse unrecognized arguments error, so a fresh user can't complete Google Workspace OAuth by following the skill as written.

Confirmed on current main (also seen on v0.15.1).

Fix Action

Fixed

Code Example

$GSETUP --auth-url --services email,calendar --format json
$GSETUP --auth-url --services calendar,drive,sheets,docs --format json
$GSETUP --auth-url --services all --format json
$GSETUP --auth-code "THE_URL_OR_CODE_THE_USER_PASTED" --format json

---

--auth-code  --auth-url  --check  --check-live  --client-secret  --install-deps  --revoke

---

$ python skills/productivity/google-workspace/scripts/setup.py --auth-url --services email,calendar --format json
usage: setup.py [-h] ...
setup.py: error: unrecognized arguments: --services email,calendar --format json
RAW_BUFFERClick to expand / collapse

Summary

The bundled productivity/google-workspace skill's SKILL.md instructs the agent to run the OAuth setup helper with --services and --format flags, but scripts/setup.py defines neither. Following the documented auth flow therefore fails with an argparse unrecognized arguments error, so a fresh user can't complete Google Workspace OAuth by following the skill as written.

Confirmed on current main (also seen on v0.15.1).

Evidence (current main)

skills/productivity/google-workspace/SKILL.md documents (≈ L122–124, L144):

$GSETUP --auth-url --services email,calendar --format json
$GSETUP --auth-url --services calendar,drive,sheets,docs --format json
$GSETUP --auth-url --services all --format json
$GSETUP --auth-code "THE_URL_OR_CODE_THE_USER_PASTED" --format json

But skills/productivity/google-workspace/scripts/setup.py defines only:

--auth-code  --auth-url  --check  --check-live  --client-secret  --install-deps  --revoke

— no --services, no --format.

Repro

$ python skills/productivity/google-workspace/scripts/setup.py --auth-url --services email,calendar --format json
usage: setup.py [-h] ...
setup.py: error: unrecognized arguments: --services email,calendar --format json

Notes / suggested fix

The docs appear to describe a planned scoped-OAuth + JSON-output interface (cf. open PR #17087, "support scoped Google Workspace OAuth") that isn't in the shipped setup.py. Either:

  • land the --services / --format interface in setup.py so it matches the docs, or
  • align SKILL.md to the flags setup.py actually accepts.

As-is the two have drifted and the documented happy-path fails for a new user.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

hermes - 💡(How to fix) Fix Bundled google-workspace skill: SKILL.md documents `--services` / `--format` setup.py flags that don't exist (auth flow fails) [1 pull requests]