@xiaotianxt/skills 0.1.0

package/skills/gws-docs/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: gws-docs
+version: 1.0.0
+description: "Read and write Google Docs."
+metadata:
+  openclaw:
+    category: "productivity"
+    requires:
+      bins: ["gws"]
+    cliHelp: "gws docs --help"
+---
+
+# docs (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 docs <resource> <method> [flags]
+```
+
+## Helper Commands
+
+| Command | Description |
+|---------|-------------|
+| [`+write`](../gws-docs-write/SKILL.md) | Append text to a document |
+
+## API Resources
+
+### documents
+
+  - `batchUpdate` — Applies one or more updates to the document. Each request is validated before being applied. If any request is not valid, then the entire request will fail and nothing will be applied. Some requests have replies to give you some information about how they are applied. Other requests do not need to return information; these each return an empty reply. The order of replies matches that of the requests.
+  - `create` — Creates a blank document using the title given in the request. Other fields in the request, including any provided content, are ignored. Returns the created document.
+  - `get` — Gets the latest version of the specified document.
+
+## Discovering Commands
+
+Before calling any API method, inspect it:
+
+```bash
+# Browse resources and methods
+gws docs --help
+
+# Inspect a method's required params, types, and defaults
+gws schema docs.<resource>.<method>
+```
+
+Use `gws schema` output to build your `--params` and `--json` flags.
+

package/skills/gws-docs-write/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: gws-docs-write
+version: 1.0.0
+description: "Google Docs: Append text to a document."
+metadata:
+  openclaw:
+    category: "productivity"
+    requires:
+      bins: ["gws"]
+    cliHelp: "gws docs +write --help"
+---
+
+# docs +write
+
+> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
+
+Append text to a document
+
+## Usage
+
+```bash
+gws docs +write --document <ID> --text <TEXT>
+```
+
+## Flags
+
+| Flag | Required | Default | Description |
+|------|----------|---------|-------------|
+| `--document` | ✓ | — | Document ID |
+| `--text` | ✓ | — | Text to append (plain text) |
+
+## Examples
+
+```bash
+gws docs +write --document DOC_ID --text 'Hello, world!'
+```
+
+## Tips
+
+- Text is inserted at the end of the document body.
+- For rich formatting, use the raw batchUpdate API instead.
+
+> [!CAUTION]
+> This is a **write** command — confirm with the user before executing.
+
+## See Also
+
+- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
+- [gws-docs](../gws-docs/SKILL.md) — All read and write google docs commands

package/skills/gws-drive/SKILL.md

@@ -0,0 +1,137 @@
+---
+name: gws-drive
+version: 1.0.0
+description: "Google Drive: Manage files, folders, and shared drives."
+metadata:
+  openclaw:
+    category: "productivity"
+    requires:
+      bins: ["gws"]
+    cliHelp: "gws drive --help"
+---
+
+# drive (v3)
+
+> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
+
+```bash
+gws drive <resource> <method> [flags]
+```
+
+## Helper Commands
+
+| Command | Description |
+|---------|-------------|
+| [`+upload`](../gws-drive-upload/SKILL.md) | Upload a file with automatic metadata |
+
+## API Resources
+
+### about
+
+  - `get` — Gets information about the user, the user's Drive, and system capabilities. For more information, see [Return user info](https://developers.google.com/workspace/drive/api/guides/user-info). Required: The `fields` parameter must be set. To return the exact fields you need, see [Return specific fields](https://developers.google.com/workspace/drive/api/guides/fields-parameter).
+
+### accessproposals
+
+  - `get` — Retrieves an access proposal by ID. For more information, see [Manage pending access proposals](https://developers.google.com/workspace/drive/api/guides/pending-access).
+  - `list` — List the access proposals on a file. For more information, see [Manage pending access proposals](https://developers.google.com/workspace/drive/api/guides/pending-access). Note: Only approvers are able to list access proposals on a file. If the user isn't an approver, a 403 error is returned.
+  - `resolve` — Approves or denies an access proposal. For more information, see [Manage pending access proposals](https://developers.google.com/workspace/drive/api/guides/pending-access).
+
+### approvals
+
+  - `get` — Gets an Approval by ID.
+  - `list` — Lists the Approvals on a file.
+
+### apps
+
+  - `get` — Gets a specific app. For more information, see [Return user info](https://developers.google.com/workspace/drive/api/guides/user-info).
+  - `list` — Lists a user's installed apps. For more information, see [Return user info](https://developers.google.com/workspace/drive/api/guides/user-info).
+
+### changes
+
+  - `getStartPageToken` — Gets the starting pageToken for listing future changes. For more information, see [Retrieve changes](https://developers.google.com/workspace/drive/api/guides/manage-changes).
+  - `list` — Lists the changes for a user or shared drive. For more information, see [Retrieve changes](https://developers.google.com/workspace/drive/api/guides/manage-changes).
+  - `watch` — Subscribes to changes for a user. For more information, see [Notifications for resource changes](https://developers.google.com/workspace/drive/api/guides/push).
+
+### channels
+
+  - `stop` — Stops watching resources through this channel. For more information, see [Notifications for resource changes](https://developers.google.com/workspace/drive/api/guides/push).
+
+### comments
+
+  - `create` — Creates a comment on a file. For more information, see [Manage comments and replies](https://developers.google.com/workspace/drive/api/guides/manage-comments). Required: The `fields` parameter must be set. To return the exact fields you need, see [Return specific fields](https://developers.google.com/workspace/drive/api/guides/fields-parameter).
+  - `delete` — Deletes a comment. For more information, see [Manage comments and replies](https://developers.google.com/workspace/drive/api/guides/manage-comments).
+  - `get` — Gets a comment by ID. For more information, see [Manage comments and replies](https://developers.google.com/workspace/drive/api/guides/manage-comments). Required: The `fields` parameter must be set. To return the exact fields you need, see [Return specific fields](https://developers.google.com/workspace/drive/api/guides/fields-parameter).
+  - `list` — Lists a file's comments. For more information, see [Manage comments and replies](https://developers.google.com/workspace/drive/api/guides/manage-comments). Required: The `fields` parameter must be set. To return the exact fields you need, see [Return specific fields](https://developers.google.com/workspace/drive/api/guides/fields-parameter).
+  - `update` — Updates a comment with patch semantics. For more information, see [Manage comments and replies](https://developers.google.com/workspace/drive/api/guides/manage-comments). Required: The `fields` parameter must be set. To return the exact fields you need, see [Return specific fields](https://developers.google.com/workspace/drive/api/guides/fields-parameter).
+
+### drives
+
+  - `create` — Creates a shared drive. For more information, see [Manage shared drives](https://developers.google.com/workspace/drive/api/guides/manage-shareddrives).
+  - `get` — Gets a shared drive's metadata by ID. For more information, see [Manage shared drives](https://developers.google.com/workspace/drive/api/guides/manage-shareddrives).
+  - `hide` — Hides a shared drive from the default view. For more information, see [Manage shared drives](https://developers.google.com/workspace/drive/api/guides/manage-shareddrives).
+  - `list` — Lists the user's shared drives. This method accepts the `q` parameter, which is a search query combining one or more search terms. For more information, see the [Search for shared drives](/workspace/drive/api/guides/search-shareddrives) guide.
+  - `unhide` — Restores a shared drive to the default view. For more information, see [Manage shared drives](https://developers.google.com/workspace/drive/api/guides/manage-shareddrives).
+  - `update` — Updates the metadata for a shared drive. For more information, see [Manage shared drives](https://developers.google.com/workspace/drive/api/guides/manage-shareddrives).
+
+### files
+
+  - `copy` — Creates a copy of a file and applies any requested updates with patch semantics. For more information, see [Create and manage files](https://developers.google.com/workspace/drive/api/guides/create-file).
+  - `create` — Creates a file. For more information, see [Create and manage files](/workspace/drive/api/guides/create-file). This method supports an */upload* URI and accepts uploaded media with the following characteristics: - *Maximum file size:* 5,120 GB - *Accepted Media MIME types:* `*/*` (Specify a valid MIME type, rather than the literal `*/*` value. The literal `*/*` is only used to indicate that any valid MIME type can be uploaded.
+  - `download` — Downloads the content of a file. For more information, see [Download and export files](https://developers.google.com/workspace/drive/api/guides/manage-downloads). Operations are valid for 24 hours from the time of creation.
+  - `export` — Exports a Google Workspace document to the requested MIME type and returns exported byte content. For more information, see [Download and export files](https://developers.google.com/workspace/drive/api/guides/manage-downloads). Note that the exported content is limited to 10 MB.
+  - `generateIds` — Generates a set of file IDs which can be provided in create or copy requests. For more information, see [Create and manage files](https://developers.google.com/workspace/drive/api/guides/create-file).
+  - `get` — Gets a file's metadata or content by ID. For more information, see [Search for files and folders](/workspace/drive/api/guides/search-files). If you provide the URL parameter `alt=media`, then the response includes the file contents in the response body. Downloading content with `alt=media` only works if the file is stored in Drive. To download Google Docs, Sheets, and Slides use [`files.export`](/workspace/drive/api/reference/rest/v3/files/export) instead.
+  - `list` — Lists the user's files. For more information, see [Search for files and folders](/workspace/drive/api/guides/search-files). This method accepts the `q` parameter, which is a search query combining one or more search terms. This method returns *all* files by default, including trashed files. If you don't want trashed files to appear in the list, use the `trashed=false` query parameter to remove trashed files from the results.
+  - `listLabels` — Lists the labels on a file. For more information, see [List labels on a file](https://developers.google.com/workspace/drive/api/guides/list-labels).
+  - `modifyLabels` — Modifies the set of labels applied to a file. For more information, see [Set a label field on a file](https://developers.google.com/workspace/drive/api/guides/set-label). Returns a list of the labels that were added or modified.
+  - `update` — Updates a file's metadata, content, or both. When calling this method, only populate fields in the request that you want to modify. When updating fields, some fields might be changed automatically, such as `modifiedDate`. This method supports patch semantics. This method supports an */upload* URI and accepts uploaded media with the following characteristics: - *Maximum file size:* 5,120 GB - *Accepted Media MIME types:* `*/*` (Specify a valid MIME type, rather than the literal `*/*` value.
+  - `watch` — Subscribes to changes to a file. For more information, see [Notifications for resource changes](https://developers.google.com/workspace/drive/api/guides/push).
+
+### operations
+
+  - `get` — Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.
+
+### permissions
+
+  - `create` — Creates a permission for a file or shared drive. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permissions operations on the same file aren't supported; only the last update is applied.
+  - `delete` — Deletes a permission. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permissions operations on the same file aren't supported; only the last update is applied.
+  - `get` — Gets a permission by ID. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing).
+  - `list` — Lists a file's or shared drive's permissions. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing).
+  - `update` — Updates a permission with patch semantics. For more information, see [Share files, folders, and drives](https://developers.google.com/workspace/drive/api/guides/manage-sharing). **Warning:** Concurrent permissions operations on the same file aren't supported; only the last update is applied.
+
+### replies
+
+  - `create` — Creates a reply to a comment. For more information, see [Manage comments and replies](https://developers.google.com/workspace/drive/api/guides/manage-comments).
+  - `delete` — Deletes a reply. For more information, see [Manage comments and replies](https://developers.google.com/workspace/drive/api/guides/manage-comments).
+  - `get` — Gets a reply by ID. For more information, see [Manage comments and replies](https://developers.google.com/workspace/drive/api/guides/manage-comments).
+  - `list` — Lists a comment's replies. For more information, see [Manage comments and replies](https://developers.google.com/workspace/drive/api/guides/manage-comments).
+  - `update` — Updates a reply with patch semantics. For more information, see [Manage comments and replies](https://developers.google.com/workspace/drive/api/guides/manage-comments).
+
+### revisions
+
+  - `delete` — Permanently deletes a file version. You can only delete revisions for files with binary content in Google Drive, like images or videos. Revisions for other files, like Google Docs or Sheets, and the last remaining file version can't be deleted. For more information, see [Manage file revisions](https://developers.google.com/drive/api/guides/manage-revisions).
+  - `get` — Gets a revision's metadata or content by ID. For more information, see [Manage file revisions](https://developers.google.com/workspace/drive/api/guides/manage-revisions).
+  - `list` — Lists a file's revisions. For more information, see [Manage file revisions](https://developers.google.com/workspace/drive/api/guides/manage-revisions). **Important:** The list of revisions returned by this method might be incomplete for files with a large revision history, including frequently edited Google Docs, Sheets, and Slides. Older revisions might be omitted from the response, meaning the first revision returned may not be the oldest existing revision.
+  - `update` — Updates a revision with patch semantics. For more information, see [Manage file revisions](https://developers.google.com/workspace/drive/api/guides/manage-revisions).
+
+### teamdrives
+
+  - `create` — Deprecated: Use `drives.create` instead.
+  - `get` — Deprecated: Use `drives.get` instead.
+  - `list` — Deprecated: Use `drives.list` instead.
+  - `update` — Deprecated: Use `drives.update` instead.
+
+## Discovering Commands
+
+Before calling any API method, inspect it:
+
+```bash
+# Browse resources and methods
+gws drive --help
+
+# Inspect a method's required params, types, and defaults
+gws schema drive.<resource>.<method>
+```
+
+Use `gws schema` output to build your `--params` and `--json` flags.
+

package/skills/gws-drive-upload/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: gws-drive-upload
+version: 1.0.0
+description: "Google Drive: Upload a file with automatic metadata."
+metadata:
+  openclaw:
+    category: "productivity"
+    requires:
+      bins: ["gws"]
+    cliHelp: "gws drive +upload --help"
+---
+
+# drive +upload
+
+> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
+
+Upload a file with automatic metadata
+
+## Usage
+
+```bash
+gws drive +upload <file>
+```
+
+## Flags
+
+| Flag | Required | Default | Description |
+|------|----------|---------|-------------|
+| `<file>` | ✓ | — | Path to file to upload |
+| `--parent` | — | — | Parent folder ID |
+| `--name` | — | — | Target filename (defaults to source filename) |
+
+## Examples
+
+```bash
+gws drive +upload ./report.pdf
+gws drive +upload ./report.pdf --parent FOLDER_ID
+gws drive +upload ./data.csv --name 'Sales Data.csv'
+```
+
+## Tips
+
+- MIME type is detected automatically.
+- Filename is inferred from the local path unless --name is given.
+
+> [!CAUTION]
+> This is a **write** command — confirm with the user before executing.
+
+## See Also
+
+- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
+- [gws-drive](../gws-drive/SKILL.md) — All manage files, folders, and shared drives commands

package/skills/gws-gmail/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: gws-gmail
+version: 1.0.0
+description: "Gmail: Send, read, and manage email."
+metadata:
+  openclaw:
+    category: "productivity"
+    requires:
+      bins: ["gws"]
+    cliHelp: "gws gmail --help"
+---
+
+# gmail (v1)
+
+> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
+
+Use this for Gmail API work through `gws`. If the user asks to operate the
+local Mimestream app, current selection, menus, or local drafts, use
+`mimestreamctl` instead.
+
+```bash
+gws gmail <resource> <method> [flags]
+```
+
+## Helper Commands
+
+| Command | Description |
+|---------|-------------|
+| [`+send`](../gws-gmail-send/SKILL.md) | Send an email |
+| [`+triage`](../gws-gmail-triage/SKILL.md) | Show unread inbox summary (sender, subject, date) |
+| [`+reply`](../gws-gmail-reply/SKILL.md) | Reply to a message (handles threading automatically) |
+| [`+reply-all`](../gws-gmail-reply-all/SKILL.md) | Reply-all to a message (handles threading automatically) |
+| [`+forward`](../gws-gmail-forward/SKILL.md) | Forward a message to new recipients |
+| [`+watch`](../gws-gmail-watch/SKILL.md) | Watch for new emails and stream them as NDJSON |
+
+## API Resources
+
+### users
+
+  - `getProfile` — Gets the current user's Gmail profile.
+  - `stop` — Stop receiving push notifications for the given user mailbox.
+  - `watch` — Set up or update a push notification watch on the given user mailbox.
+  - `drafts` — Operations on the 'drafts' resource
+  - `history` — Operations on the 'history' resource
+  - `labels` — Operations on the 'labels' resource
+  - `messages` — Operations on the 'messages' resource
+  - `settings` — Operations on the 'settings' resource
+  - `threads` — Operations on the 'threads' resource
+
+## Discovering Commands
+
+Before calling any API method, inspect it:
+
+```bash
+# Browse resources and methods
+gws gmail --help
+
+# Inspect a method's required params, types, and defaults
+gws schema gmail.<resource>.<method>
+```
+
+Use `gws schema` output to build your `--params` and `--json` flags.

package/skills/gws-gmail-forward/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: gws-gmail-forward
+version: 1.0.0
+description: "Gmail: Forward a message to new recipients."
+metadata:
+  openclaw:
+    category: "productivity"
+    requires:
+      bins: ["gws"]
+    cliHelp: "gws gmail +forward --help"
+---
+
+# gmail +forward
+
+> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
+
+Forward a message to new recipients
+
+## Usage
+
+```bash
+gws gmail +forward --message-id <ID> --to <EMAILS>
+```
+
+## Flags
+
+| Flag | Required | Default | Description |
+|------|----------|---------|-------------|
+| `--message-id` | ✓ | — | Gmail message ID to forward |
+| `--to` | ✓ | — | Recipient email address(es), comma-separated |
+| `--from` | — | — | Sender address (for send-as/alias; omit to use account default) |
+| `--cc` | — | — | CC email address(es), comma-separated |
+| `--bcc` | — | — | BCC email address(es), comma-separated |
+| `--body` | — | — | Optional note to include above the forwarded message (plain text, or HTML with --html) |
+| `--html` | — | — | Send as HTML (formats forwarded block with Gmail styling; treat --body as HTML) |
+| `--dry-run` | — | — | Show the request that would be sent without executing it |
+
+## Examples
+
+```bash
+gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com
+gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --body 'FYI see below'
+gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --cc eve@example.com
+gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --bcc secret@example.com
+gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --body '<p>FYI</p>' --html
+```
+
+## Tips
+
+- Includes the original message with sender, date, subject, and recipients.
+
+## See Also
+
+- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
+- [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands

package/skills/gws-gmail-reply/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: gws-gmail-reply
+version: 1.0.0
+description: "Gmail: Reply to a message (handles threading automatically)."
+metadata:
+  openclaw:
+    category: "productivity"
+    requires:
+      bins: ["gws"]
+    cliHelp: "gws gmail +reply --help"
+---
+
+# gmail +reply
+
+> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
+
+Reply to a message (handles threading automatically)
+
+## Usage
+
+```bash
+gws gmail +reply --message-id <ID> --body <TEXT>
+```
+
+## Flags
+
+| Flag | Required | Default | Description |
+|------|----------|---------|-------------|
+| `--message-id` | ✓ | — | Gmail message ID to reply to |
+| `--body` | ✓ | — | Reply body (plain text, or HTML with --html) |
+| `--from` | — | — | Sender address (for send-as/alias; omit to use account default) |
+| `--to` | — | — | Additional To email address(es), comma-separated |
+| `--cc` | — | — | Additional CC email address(es), comma-separated |
+| `--bcc` | — | — | BCC email address(es), comma-separated |
+| `--html` | — | — | Send as HTML (quotes original with Gmail styling; treat --body as HTML) |
+| `--dry-run` | — | — | Show the request that would be sent without executing it |
+
+## Examples
+
+```bash
+gws gmail +reply --message-id 18f1a2b3c4d --body 'Thanks, got it!'
+gws gmail +reply --message-id 18f1a2b3c4d --body 'Looping in Carol' --cc carol@example.com
+gws gmail +reply --message-id 18f1a2b3c4d --body 'Adding Dave' --to dave@example.com
+gws gmail +reply --message-id 18f1a2b3c4d --body 'Reply' --bcc secret@example.com
+gws gmail +reply --message-id 18f1a2b3c4d --body '<b>Bold reply</b>' --html
+```
+
+## Tips
+
+- Automatically sets In-Reply-To, References, and threadId headers.
+- Quotes the original message in the reply body.
+- --to adds extra recipients to the To field.
+- For reply-all, use +reply-all instead.
+
+## See Also
+
+- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
+- [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands

package/skills/gws-gmail-reply-all/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: gws-gmail-reply-all
+version: 1.0.0
+description: "Gmail: Reply-all to a message (handles threading automatically)."
+metadata:
+  openclaw:
+    category: "productivity"
+    requires:
+      bins: ["gws"]
+    cliHelp: "gws gmail +reply-all --help"
+---
+
+# gmail +reply-all
+
+> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
+
+Reply-all to a message (handles threading automatically)
+
+## Usage
+
+```bash
+gws gmail +reply-all --message-id <ID> --body <TEXT>
+```
+
+## Flags
+
+| Flag | Required | Default | Description |
+|------|----------|---------|-------------|
+| `--message-id` | ✓ | — | Gmail message ID to reply to |
+| `--body` | ✓ | — | Reply body (plain text, or HTML with --html) |
+| `--from` | — | — | Sender address (for send-as/alias; omit to use account default) |
+| `--to` | — | — | Additional To email address(es), comma-separated |
+| `--cc` | — | — | Additional CC email address(es), comma-separated |
+| `--bcc` | — | — | BCC email address(es), comma-separated |
+| `--remove` | — | — | Exclude recipients from the outgoing reply (comma-separated emails) |
+| `--html` | — | — | Send as HTML (quotes original with Gmail styling; treat --body as HTML) |
+| `--dry-run` | — | — | Show the request that would be sent without executing it |
+
+## Examples
+
+```bash
+gws gmail +reply-all --message-id 18f1a2b3c4d --body 'Sounds good to me!'
+gws gmail +reply-all --message-id 18f1a2b3c4d --body 'Updated' --remove bob@example.com
+gws gmail +reply-all --message-id 18f1a2b3c4d --body 'Adding Eve' --cc eve@example.com
+gws gmail +reply-all --message-id 18f1a2b3c4d --body 'Adding Dave' --to dave@example.com
+gws gmail +reply-all --message-id 18f1a2b3c4d --body 'Reply' --bcc secret@example.com
+gws gmail +reply-all --message-id 18f1a2b3c4d --body '<i>Noted</i>' --html
+```
+
+## Tips
+
+- Replies to the sender and all original To/CC recipients.
+- Use --to to add extra recipients to the To field.
+- Use --cc to add new CC recipients.
+- Use --bcc for recipients who should not be visible to others.
+- Use --remove to exclude recipients from the outgoing reply, including the sender or Reply-To target.
+- The command fails if no To recipient remains after exclusions and --to additions.
+
+## See Also
+
+- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
+- [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands

package/skills/gws-gmail-send/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: gws-gmail-send
+version: 1.0.0
+description: "Gmail: Send an email."
+metadata:
+  openclaw:
+    category: "productivity"
+    requires:
+      bins: ["gws"]
+    cliHelp: "gws gmail +send --help"
+---
+
+# gmail +send
+
+> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
+
+Send an email
+
+## Usage
+
+```bash
+gws gmail +send --to <EMAILS> --subject <SUBJECT> --body <TEXT>
+```
+
+## Flags
+
+| Flag | Required | Default | Description |
+|------|----------|---------|-------------|
+| `--to` | ✓ | — | Recipient email address(es), comma-separated |
+| `--subject` | ✓ | — | Email subject |
+| `--body` | ✓ | — | Email body (plain text, or HTML with --html) |
+| `--cc` | — | — | CC email address(es), comma-separated |
+| `--bcc` | — | — | BCC email address(es), comma-separated |
+| `--html` | — | — | Treat --body as HTML content (default is plain text) |
+| `--dry-run` | — | — | Show the request that would be sent without executing it |
+
+## Examples
+
+```bash
+gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi Alice!'
+gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi!' --cc bob@example.com
+gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi!' --bcc secret@example.com
+gws gmail +send --to alice@example.com --subject 'Hello' --body '<b>Bold</b> text' --html
+```
+
+## Tips
+
+- Handles RFC 2822 formatting and base64 encoding automatically.
+- For attachments, use the raw API instead: gws gmail users messages send --json '...'
+
+> [!CAUTION]
+> This is a **write** command — confirm with the user before executing.
+
+## See Also
+
+- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
+- [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands

package/skills/gws-gmail-triage/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: gws-gmail-triage
+version: 1.0.0
+description: "Gmail: Show unread inbox summary (sender, subject, date)."
+metadata:
+  openclaw:
+    category: "productivity"
+    requires:
+      bins: ["gws"]
+    cliHelp: "gws gmail +triage --help"
+---
+
+# gmail +triage
+
+> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
+
+Show unread inbox summary (sender, subject, date)
+
+## Usage
+
+```bash
+gws gmail +triage
+```
+
+## Flags
+
+| Flag | Required | Default | Description |
+|------|----------|---------|-------------|
+| `--max` | — | 20 | Maximum messages to show (default: 20) |
+| `--query` | — | — | Gmail search query (default: is:unread) |
+| `--labels` | — | — | Include label names in output |
+
+## Examples
+
+```bash
+gws gmail +triage
+gws gmail +triage --max 5 --query 'from:boss'
+gws gmail +triage --format json | jq '.[].subject'
+gws gmail +triage --labels
+```
+
+## Tips
+
+- Read-only — never modifies your mailbox.
+- Defaults to table output format.
+
+## See Also
+
+- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
+- [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands