Skip to content

Commit 4ddec67

Browse files
authored
[codex] generate modular agent skills (#864)
* feat(skills): add generated agent workflows * fix(skills): use runtime readonly safety * fix(skills): isolate attachment downloads * fix(skills): support existing node runtimes * fix(skills): isolate schema generation environment
1 parent 4cac149 commit 4ddec67

65 files changed

Lines changed: 1570 additions & 14 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.agents/skills/gog-admin/SKILL.md

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
---
2+
name: gog-admin
3+
description: "Workspace Admin operations through gog."
4+
---
5+
6+
# Workspace Admin
7+
8+
<!-- Generated by scripts/gen-agent-skills.mjs; do not edit. -->
9+
10+
Use `gog` for Workspace Admin operations. Read `../gog/SKILL.md` first for shared auth,
11+
output, safety, and live-write rules.
12+
13+
## Safe start
14+
15+
```bash
16+
gog auth list --check --json --no-input
17+
gog schema admin --json
18+
gog --readonly --account [email protected] admin --help
19+
```
20+
21+
- Select the account explicitly with `--account`.
22+
- Use `--json --wrap-untrusted` for agent-readable Google content.
23+
- Use `--readonly` when the task must not mutate Google data.
24+
- Use `--no-input` in automation and `--dry-run` before supported writes.
25+
- Confirm the exact account, object, and mutation before any write or delete.
26+
27+
## Commands
28+
29+
| Command | Purpose |
30+
| --- | --- |
31+
| `groups` | Manage Workspace groups |
32+
| `orgunits` | Manage Workspace organizational units |
33+
| `users` | Manage Workspace users |
34+
35+
Run `gog admin <command> --help` for flags and `gog schema admin <command> --json`
36+
for the machine-readable contract. Do not guess command syntax.
Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
interface:
2+
display_name: "gog Workspace Admin"
3+
short_description: "Operate Workspace Admin safely with gog"
4+
default_prompt: "Use $gog-admin to perform this Workspace Admin task safely."
Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
---
2+
name: gog-analytics
3+
description: "Google Analytics operations through gog."
4+
---
5+
6+
# Google Analytics
7+
8+
<!-- Generated by scripts/gen-agent-skills.mjs; do not edit. -->
9+
10+
Use `gog` for Google Analytics operations. Read `../gog/SKILL.md` first for shared auth,
11+
output, safety, and live-write rules.
12+
13+
## Safe start
14+
15+
```bash
16+
gog auth list --check --json --no-input
17+
gog schema analytics --json
18+
gog --readonly --account [email protected] analytics --help
19+
```
20+
21+
- Select the account explicitly with `--account`.
22+
- Use `--json --wrap-untrusted` for agent-readable Google content.
23+
- Use `--readonly` when the task must not mutate Google data.
24+
- Use `--no-input` in automation and `--dry-run` before supported writes.
25+
- Confirm the exact account, object, and mutation before any write or delete.
26+
27+
## Commands
28+
29+
| Command | Purpose |
30+
| --- | --- |
31+
| `accounts` | List GA4 account summaries |
32+
| `report` | Run a GA4 report (Analytics Data API) |
33+
34+
Run `gog analytics <command> --help` for flags and `gog schema analytics <command> --json`
35+
for the machine-readable contract. Do not guess command syntax.
Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
interface:
2+
display_name: "gog Google Analytics"
3+
short_description: "Operate Google Analytics safely with gog"
4+
default_prompt: "Use $gog-analytics to perform this Google Analytics task safely."
Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
---
2+
name: gog-appscript
3+
description: "Apps Script operations through gog."
4+
---
5+
6+
# Apps Script
7+
8+
<!-- Generated by scripts/gen-agent-skills.mjs; do not edit. -->
9+
10+
Use `gog` for Apps Script operations. Read `../gog/SKILL.md` first for shared auth,
11+
output, safety, and live-write rules.
12+
13+
## Safe start
14+
15+
```bash
16+
gog auth list --check --json --no-input
17+
gog schema appscript --json
18+
gog --readonly --account [email protected] appscript --help
19+
```
20+
21+
- Select the account explicitly with `--account`.
22+
- Use `--json --wrap-untrusted` for agent-readable Google content.
23+
- Use `--readonly` when the task must not mutate Google data.
24+
- Use `--no-input` in automation and `--dry-run` before supported writes.
25+
- Confirm the exact account, object, and mutation before any write or delete.
26+
27+
## Commands
28+
29+
| Command | Purpose |
30+
| --- | --- |
31+
| `content` | Get Apps Script project content |
32+
| `create` | Create an Apps Script project |
33+
| `get` | Get Apps Script project metadata |
34+
| `run` | Run a deployed Apps Script function |
35+
36+
Run `gog appscript <command> --help` for flags and `gog schema appscript <command> --json`
37+
for the machine-readable contract. Do not guess command syntax.
Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
interface:
2+
display_name: "gog Apps Script"
3+
short_description: "Operate Apps Script safely with gog"
4+
default_prompt: "Use $gog-appscript to perform this Apps Script task safely."
Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
---
2+
name: gog-calendar
3+
description: "Google Calendar operations through gog."
4+
---
5+
6+
# Google Calendar
7+
8+
<!-- Generated by scripts/gen-agent-skills.mjs; do not edit. -->
9+
10+
Use `gog` for Google Calendar operations. Read `../gog/SKILL.md` first for shared auth,
11+
output, safety, and live-write rules.
12+
13+
## Safe start
14+
15+
```bash
16+
gog auth list --check --json --no-input
17+
gog schema calendar --json
18+
gog --readonly --account [email protected] calendar events --today --json --wrap-untrusted
19+
```
20+
21+
- Select the account explicitly with `--account`.
22+
- Use `--json --wrap-untrusted` for agent-readable Google content.
23+
- Use `--readonly` when the task must not mutate Google data.
24+
- Use `--no-input` in automation and `--dry-run` before supported writes.
25+
- Confirm the exact account, object, and mutation before any write or delete.
26+
27+
## Commands
28+
29+
| Command | Purpose |
30+
| --- | --- |
31+
| `acl` | List calendar ACL |
32+
| `alias` | Manage calendar aliases |
33+
| `calendars` | List calendars |
34+
| `colors` | Show calendar colors |
35+
| `conflicts` | Find busy-time overlaps across calendars |
36+
| `create` | Create an event |
37+
| `create-calendar` | Create a new secondary calendar |
38+
| `delete` | Delete an event |
39+
| `delete-calendar` | Delete an owned secondary calendar |
40+
| `event` | Get event |
41+
| `events` | List events from a calendar or all calendars |
42+
| `focus-time` | Create a Focus Time block |
43+
| `freebusy` | Get free/busy |
44+
| `move` | Move an event to another calendar |
45+
| `out-of-office` | Create an Out of Office event |
46+
| `propose-time` | Generate URL to propose a new meeting time (browser-only feature) |
47+
| `raw` | Dump raw Google Calendar API response as JSON (Events.Get; lossless; for scripting and LLM consumption) |
48+
| `respond` | Respond to an event invitation |
49+
| `search` | Search events |
50+
| `subscribe` | Add a calendar to your calendar list |
51+
| `team` | Show events for Workspace group members (service account, direct token, or ADC) |
52+
| `time` | Show server time |
53+
| `unsubscribe` | Remove a calendar from your calendar list |
54+
| `update` | Update an event |
55+
| `users` | List workspace users (use their email as calendar ID) |
56+
| `working-location` | Set working location (home/office/custom) |
57+
58+
Run `gog calendar <command> --help` for flags and `gog schema calendar <command> --json`
59+
for the machine-readable contract. Do not guess command syntax.
Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
interface:
2+
display_name: "gog Google Calendar"
3+
short_description: "Operate Google Calendar safely with gog"
4+
default_prompt: "Use $gog-calendar to perform this Google Calendar task safely."

.agents/skills/gog-chat/SKILL.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
---
2+
name: gog-chat
3+
description: "Google Chat operations through gog."
4+
---
5+
6+
# Google Chat
7+
8+
<!-- Generated by scripts/gen-agent-skills.mjs; do not edit. -->
9+
10+
Use `gog` for Google Chat operations. Read `../gog/SKILL.md` first for shared auth,
11+
output, safety, and live-write rules.
12+
13+
## Safe start
14+
15+
```bash
16+
gog auth list --check --json --no-input
17+
gog schema chat --json
18+
gog --readonly --account [email protected] chat --help
19+
```
20+
21+
- Select the account explicitly with `--account`.
22+
- Use `--json --wrap-untrusted` for agent-readable Google content.
23+
- Use `--readonly` when the task must not mutate Google data.
24+
- Use `--no-input` in automation and `--dry-run` before supported writes.
25+
- Confirm the exact account, object, and mutation before any write or delete.
26+
27+
## Commands
28+
29+
| Command | Purpose |
30+
| --- | --- |
31+
| `dm` | Direct messages |
32+
| `messages` | Chat messages |
33+
| `spaces` | Chat spaces |
34+
| `threads` | Chat threads |
35+
36+
Run `gog chat <command> --help` for flags and `gog schema chat <command> --json`
37+
for the machine-readable contract. Do not guess command syntax.
Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
interface:
2+
display_name: "gog Google Chat"
3+
short_description: "Operate Google Chat safely with gog"
4+
default_prompt: "Use $gog-chat to perform this Google Chat task safely."

0 commit comments

Comments
 (0)