gws-admin-reports — скилл для Claude: аудит-логи Google Workspace
Скилл даёт агенту доступ к Admin SDK Reports API: аудит-логи и отчёты об использовании аккаунта Google Workspace.
npx skills add googleworkspace/cli --skill gws-admin-reports -a claude-codeЧто делает gws-admin-reports
Скилл оборачивает reports_v1 Admin SDK в команды gws admin-reports . Через него агент вытаскивает список активностей по аккаунту и приложению — например, Admin console или Google Drive — и отчёты об использовании: по клиенту, по сущностям, по отдельным пользователям.
Внутри пять ресурсов: activities с методами list и watch, channels.stop для отключения уведомлений, а также customerUsageReports.get, entityUsageReports.get и userUsageReport.get. Перед вызовом метода агент смотрит gws schema admin-reports.. и по этой схеме собирает флаги --params и --json.
Нужен установленный бинарь gws и файл ../gws-shared/SKILL.md с настройками авторизации. Если его нет, выполните gws generate-skills. Ставьте, если регулярно копаетесь в логах админки Workspace руками; для разовой выгрузки проще обойтись веб-интерфейсом.
Какие задачи решает
- выгрузить аудит-лог по действиям в Admin console
- получить отчёт об использовании аккаунта Google Workspace
- посмотреть статистику по конкретному пользователю
- подписаться на уведомления о новых активностях
- отключить канал уведомлений, когда он больше не нужен
Примеры запросов агенту
- покажи список активностей за последнюю неделю по Google Drive
- собери отчёт об использовании по пользователям аккаунта
- какие параметры нужны для gws admin-reports userUsageReport get?
Как установить gws-admin-reports
1Через Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-admin-reports -a claude-code2Вручную: положить файлы
~/.claude/skills/gws-admin-reports/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/gws-admin-reports/
1Через Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-admin-reports -a codex2Вручную: положить файлы
.agents/skills/gws-admin-reports/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-admin-reports -a cursor2Вручную: положить файлы
.cursor/skills/gws-admin-reports/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install googleworkspace/cli gws-admin-reports2Вручную: положить файлы
.github/skills/gws-admin-reports/SKILL.md1Через Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-admin-reports -a gemini-cli2Командой платформы
gemini skills install https://github.com/googleworkspace/cli --path skills/gws-admin-reportsВручную: положить файлы
.devin/skills/gws-admin-reports/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-admin-reports -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Из того же набора95
Весь набор →Похожие
Вопросы о gws-admin-reports
Как установить gws-admin-reports в Claude?
Выполните npx skills add googleworkspace/cli --skill gws-admin-reports -a claude-code. Файл скилла появится в ~/.claude/skills/gws-admin-reports/SKILL.md.
Что делает gws-admin-reports?
Даёт агенту команды для Admin SDK Reports API: аудит-логи активностей и отчёты об использовании аккаунта, сущностей и пользователей Google Workspace.
Что нужно для работы скилла?
Установленный бинарь gws и файл ../gws-shared/SKILL.md с настройками авторизации. Если файла нет, создайте его командой gws generate-skills.
Исходный текст
SKILL.md · Apache-2.0
---
name: gws-admin-reports
description: "Google Workspace Admin SDK: Audit logs and usage reports."
metadata:
version: 0.22.5
openclaw:
category: "productivity"
requires:
bins:
- gws
cliHelp: "gws admin-reports --help"
---
# admin-reports (reports_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 admin-reports <resource> <method> [flags]
```
## API Resources
### activities
- `list` — Retrieves a list of activities for a specific customer's account and application such as the Admin console application or the Google Drive application. For more information, see the guides for administrator and Google Drive activity reports. For more information about the activity report's parameters, see the activity parameters reference guides.
- `watch` — Start receiving notifications for account activities. For more information, see Receiving Push Notifications.
### channels
- `stop` — Stop watching resources through this channel.
### customerUsageReports
- `get` — Retrieves a report which is a collection of properties and statistics for a specific customer's account. For more information, see the Customers Usage Report guide. For more information about the customer report's parameters, see the Customers Usage parameters reference guides.
### entityUsageReports
- `get` — Retrieves a report which is a collection of properties and statistics for entities used by users within the account. For more information, see the Entities Usage Report guide. For more information about the entities report's parameters, see the Entities Usage parameters reference guides.
### userUsageReport
- `get` — Retrieves a report which is a collection of properties and statistics for a set of users with the account. For more information, see the User Usage Report guide. For more information about the user report's parameters, see the Users Usage parameters reference guides.
## Discovering Commands
Before calling any API method, inspect it:
```bash
# Browse resources and methods
gws admin-reports --help
# Inspect a method's required params, types, and defaults
gws schema admin-reports.<resource>.<method>
```
Use `gws schema` output to build your `--params` and `--json` flags.
© googleworkspace · Apache-2.0 · googleworkspace/cli