@genspark/cli 1.0.11 → 1.0.13

package/skills/gsk-claw-share-link/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: gsk-claw-share-link
+version: 1.0.0
+description: Generate a time-limited share URL for a file on a Genspark Claw VM. Use
+  when the user is not in the web UI and you need to share a generated file.
+metadata:
+  category: claw
+  requires:
+    bins:
+    - gsk
+  cliHelp: gsk claw share_link --help
+---
+
+# gsk-claw-share-link
+
+**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
+
+Generate a time-limited share URL for a file on a Genspark Claw VM. Use when the user is not in the web UI and you need to share a generated file.
+
+## Usage
+
+```bash
+gsk claw share_link [options]
+```
+
+**Aliases:** `share-link`
+
+## Flags
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `-n`, `--vm_name` | Yes | Name of the VM that hosts the file. (string) |
+| `<path>` (positional) | Yes | Absolute file path on the VM (e.g. /home/user/report.pdf). (string) |
+| `-e`, `--expires_minutes` | No | Link validity in minutes, 1–1440. Default 10. (integer) |
+| `-p`, `--password` | No | Optional password to protect the share link. Recipients must enter this password to view the file. Must be at least 8 characters with letters, digits, and special characters (e.g. 'xK9#mP2q'). Do NOT use simple dictionary words. (string) |
+
+## See Also
+
+- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags

package/skills/gsk-create-task/SKILL.md

@@ -30,7 +30,7 @@ gsk task [options]
 
 | Flag | Required | Description |
 |------|----------|-------------|
-| `<task_type>` (positional) | Yes | The type of task to create: - super_agent: Create general super agent - podcasts: Create audio podcasts with AI characters - docs: Create and edit HTML/Markdown documents. Create a professional document with Word-like formatting as a single-file HTML. Perfect for reports, articles, academic papers, and formal documents. **Guidelines** 1. This tool can be directly called when user explicitly wants to create: - A document or report - An article or academic paper - A formal document with professional formatting - A document for print or PDF export  2. In situations other than those mentioned above, you need to ask the user first and only call this tool after getting permission when user wants to create: - A better formatted text, but hasn't explicitly mentioned creating a document - Content that needs professional document formatting  **Limitations** - Document styling resembles Microsoft Word format, not web page design - Usually takes time to generate, so please strictly follow the guidelines above - slides: Create presentation slides. Convert collected materials into a set of slides written in HTML format and display them. Limitation: a) It usually takes minutes. Ask the user whether they want to wait for a longer time before starting if they haven't explicitly indicated they want to generate a set of slides; - deep_research: Create deep research agent for task on a 'deep research' topic (e.g. 'deep research on Tesla', 'analyze Tesla in depth'). Also can handle user's 'continue deep research' request - website: Create a professional agent for building websites and web pages - video_generation: Large-scale batch video generation with complex inter-task dependencies. Best for workflows requiring coordinated, multi-step video pipelines where tasks depend on each other's outputs. Supports text-to-video, image-to-video (query should contain the image url), and merging multiple video clips. Can reuse agent. NOT recommended for small-scale, simple, or independent video tasks — for those, use <tool>video_generation</tool> directly instead. If there is a resource generation list, you can directly pass the resource list URL in the query, http(s):// or aidrive:// - audio_generation: Large-scale batch TTS (text-to-speech) generation with complex inter-task dependencies. Best for workflows requiring coordinated, multi-step TTS pipelines where tasks depend on each other's outputs. Supports text-to-speech, voiceovers, multi-speaker dialogues, and merging multiple audio clips. Can reuse agent. NOT recommended for small-scale, simple, or independent TTS tasks — for those, use <tool>audio_generation</tool> directly instead. If there is a resource generation list, you can directly pass the resource list URL in the query, http(s):// or aidrive:// - cross_check: Fact-check and verify claims or statements. Use when the user wants to verify whether a statement is true, check facts, or cross-reference claims against multiple sources. The agent systematically searches for evidence, evaluates source credibility, and provides a detailed verification report with supporting references. - sheets: Create spreadsheet. This tool can convert collected materials into a spreadsheet, use only when user is explicitly requesting you to create a spreadsheet or excel table. (string, one of: super_agent, podcasts, docs, slides, deep_research, website, video_generation, audio_generation, meeting_notes, cross_check, sheets) |
+| `<task_type>` (positional) | Yes | The type of task to create: - super_agent: Create general super agent - podcasts: Create audio podcasts with AI characters - docs: Create and edit HTML/Markdown documents. Create a professional document with Word-like formatting as a single-file HTML. Perfect for reports, articles, academic papers, and formal documents. **Guidelines** 1. This tool can be directly called when user explicitly wants to create: - A document or report - An article or academic paper - A formal document with professional formatting - A document for print or PDF export  2. In situations other than those mentioned above, you need to ask the user first and only call this tool after getting permission when user wants to create: - A better formatted text, but hasn't explicitly mentioned creating a document - Content that needs professional document formatting  **Limitations** - Document styling resembles Microsoft Word format, not web page design - Usually takes time to generate, so please strictly follow the guidelines above - slides: Create presentation slides. Convert collected materials into a set of slides written in HTML format and display them. Limitation: a) It usually takes minutes. Ask the user whether they want to wait for a longer time before starting if they haven't explicitly indicated they want to generate a set of slides; - website: Create a professional agent for building websites and web pages - deep_research: Create deep research agent for task on a 'deep research' topic (e.g. 'deep research on Tesla', 'analyze Tesla in depth'). Also can handle user's 'continue deep research' request - video_generation: Large-scale batch video generation with complex inter-task dependencies. Best for workflows requiring coordinated, multi-step video pipelines where tasks depend on each other's outputs. Supports text-to-video, image-to-video (query should contain the image url), and merging multiple video clips. Can reuse agent. NOT recommended for small-scale, simple, or independent video tasks — for those, use <tool>video_generation</tool> directly instead. If there is a resource generation list, you can directly pass the resource list URL in the query, http(s):// or aidrive:// - audio_generation: Large-scale batch TTS (text-to-speech) generation with complex inter-task dependencies. Best for workflows requiring coordinated, multi-step TTS pipelines where tasks depend on each other's outputs. Supports text-to-speech, voiceovers, multi-speaker dialogues, and merging multiple audio clips. Can reuse agent. NOT recommended for small-scale, simple, or independent TTS tasks — for those, use <tool>audio_generation</tool> directly instead. If there is a resource generation list, you can directly pass the resource list URL in the query, http(s):// or aidrive:// - cross_check: Fact-check and verify claims or statements. Use when the user wants to verify whether a statement is true, check facts, or cross-reference claims against multiple sources. The agent systematically searches for evidence, evaluates source credibility, and provides a detailed verification report with supporting references. - sheets: Create spreadsheet. This tool can convert collected materials into a spreadsheet, use only when user is explicitly requesting you to create a spreadsheet or excel table. (string, one of: super_agent, podcasts, docs, slides, website, deep_research, video_generation, audio_generation, cross_check, meeting_notes, sheets) |
 | `--task_name` | Yes | Name for the task/project (string) |
 | `--query` | Yes | Query for the task. The ending should clearly state what needs to be done, such as generating a doc/slides etc. (string) |
 | `--instructions` | Yes | Detailed instructions for the task. This will be set as system prompt to the specialized agent. (string) |

package/skills/gsk-github/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: gsk-github
+version: 1.0.0
+description: 'GitHub operations. Actions: list_repos, search_issues, create_issue,
+  update_issue.'
+metadata:
+  category: general
+  requires:
+    bins:
+    - gsk
+  cliHelp: gsk github --help
+---
+
+# gsk-github
+
+**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
+
+GitHub operations. Actions: list_repos, search_issues, create_issue, update_issue.
+
+## Usage
+
+```bash
+gsk github [options]
+```
+
+## Flags
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `<action>` (positional) | Yes | Action to perform. 'list_repos': List repositories for the authenticated user; 'search_issues': Search issues and pull requests; 'create_issue': Create a new issue; 'update_issue': Update an existing issue (string, one of: list_repos, search_issues, create_issue, update_issue) |
+| `--visibility` | No | [list_repos] Filter by repository visibility. Default: all. (string, one of: all, public, private) |
+| `--affiliation` | No | [list_repos] Comma-separated list of affiliation types: owner, collaborator, organization_member. Default: owner,collaborator,organization_member. (string) |
+| `--sort` | No | [list_repos] How to sort the results. Default: updated. \| [search_issues] How to sort results. Default: best match. (string, one of: created, updated, pushed, full_name) |
+| `--direction` | No | [list_repos] Sort direction. Default: desc (except for full_name). (string, one of: asc, desc) |
+| `--per_page` | No | [list_repos] Number of results per page (max 100). Default: 30. \| [search_issues] Number of results per page (max 100). Default: 30. (integer) |
+| `--page` | No | [list_repos] Page number of the results. Default: 1. \| [search_issues] Page number of the results. Default: 1. (integer) |
+| `--q` | No | [search_issues] Search query using GitHub search syntax. Examples: 'repo:owner/repo is:issue is:open', 'author:username', 'label:bug', 'state:closed' (string) |
+| `--repo` | No | [search_issues] Repository in 'owner/repo' format to search within. Will be added to the query. \| [create_issue] The name of the repository (without the owner prefix). \| [update_issue] The name of the repository (without the owner prefix). (string) |
+| `--state` | No | [search_issues] Filter by issue state. Will be added to the query. \| [update_issue] State of the issue. Use 'closed' to close the issue, 'open' to reopen it. (string, one of: open, closed, all) |
+| `--labels` | No | [search_issues] Comma-separated list of labels to filter by. \| [create_issue] Labels to associate with this issue (e.g., ['bug', 'enhancement']). \| [update_issue] Labels to set on this issue (replaces existing labels). (string) |
+| `--assignee` | No | [search_issues] Filter by assignee username. (string) |
+| `--order` | No | [search_issues] Sort order. Default: desc. (string, one of: asc, desc) |
+| `--owner` | No | [create_issue] The account owner of the repository (username or organization name). \| [update_issue] The account owner of the repository (username or organization name). (string) |
+| `--title` | No | [create_issue] The title of the issue (required). \| [update_issue] New title of the issue. (string) |
+| `--body` | No | [create_issue] The contents/description of the issue. Supports Markdown. \| [update_issue] New contents/description of the issue. Supports Markdown. (string) |
+| `--assignees` | No | [create_issue] Logins/usernames of users to assign to this issue. \| [update_issue] Logins/usernames to assign to this issue (replaces existing assignees). (array) |
+| `--milestone` | No | [create_issue] The milestone number to associate with this issue. \| [update_issue] The milestone number to associate with this issue. Set to null to remove milestone. (integer) |
+| `--issue_number` | No | [update_issue] The number of the issue to update (required). (integer) |
+
+## See Also
+
+- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags

package/skills/gsk-gmail/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: gsk-gmail
+version: 1.0.0
+description: 'Gmail operations. Actions: search, read, send, reply, forward, delete,
+  archive, move, mark_as_read, add_label, remove_label, create_label, get_attachment,
+  list_send_as.'
+metadata:
+  category: general
+  requires:
+    bins:
+    - gsk
+  cliHelp: gsk gmail --help
+---
+
+# gsk-gmail
+
+**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
+
+Gmail operations. Actions: search, read, send, reply, forward, delete, archive, move, mark_as_read, add_label, remove_label, create_label, get_attachment, list_send_as.
+
+## Usage
+
+```bash
+gsk gmail [options]
+```
+
+## Flags
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `<action>` (positional) | Yes | Action to perform. 'search': Search emails by query; 'read': Read a specific email by ID; 'send': Compose and send an email; 'reply': Reply to an existing email; 'forward': Forward an email to new recipients; 'delete': Delete an email; 'archive': Archive an email; 'move': Move an email to a different label/folder; 'mark_as_read': Mark an email as read or unread; 'add_label': Add a label to an email; 'remove_label': Remove a label from an email; 'create_label': Create a new Gmail label; 'get_attachment': Download an email attachment; 'list_send_as': List available send-as aliases (string, one of: search, read, send, reply, forward, delete, archive, move, mark_as_read, add_label, remove_label, create_label, get_attachment, list_send_as) |
+| `--query` | No | [search] Query to filter emails using Gmail search syntax. Examples:\n- Simple: 'meeting'\n- From Sender: 'from:boss@example.com'\n- Subject: 'subject:report'\n- In Folder: 'in:spam', 'in:inbox', 'in:trash', 'in:sent'\n- Label: 'label:important'\n- Unread: 'is:unread'\n- Unread in Spam: 'in:spam is:unread'\n- Has Attachment: 'has:attachment'\n- Date Range: 'after:2024/01/01 before:2024/01/31'\n- Newer Than: 'newer_than:7d' (7 days)\n- Older Than: 'older_than:1m' (1 month)\nNote: Some queries like 'is:recent' are invalid. (string) |
+| `--after_date` | No | [search] Filter emails received after this date (inclusive). Format: YYYY/MM/DD (e.g., '2024/01/01'). This is equivalent to adding 'after:YYYY/MM/DD' to the query. (string) |
+| `--before_date` | No | [search] Filter emails received before this date (exclusive). Format: YYYY/MM/DD (e.g., '2024/01/31'). This is equivalent to adding 'before:YYYY/MM/DD' to the query. (string) |
+| `--next_page_token` | No | [search] Next page token to retrieve more emails (optional). (string) |
+| `--auto_paginate` | No | [search] If true, automatically fetches multiple pages until reaching max_total_results (default: 500). Returns ALL emails matching the query. (boolean) |
+| `--max_total_results` | No | [search] Maximum total results to fetch when auto_paginate is true. Default: 500, Maximum: 500. (integer) |
+| `--from_account` | No | [search] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [read] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [send] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [reply] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [forward] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [delete] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [archive] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [move] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [mark_as_read] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [add_label] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [remove_label] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [create_label] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [get_attachment] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [list_send_as] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. (string) |
+| `--id` | No | [read] The ID of the email to retrieve and read (string) |
+| `--title` | No | [read] The title of the email to retrieve and read (string) |
+| `--question` | No | [read] Question to answer guiding how to process the email content (string) |
+| `--download_attachments` | No | [read] Whether need to download attachments from the email to analysis (boolean) |
+| `--aidrive_path` | No | [read] Path in AIDrive where attachments should be saved. Default is /gmail_attachments/ \| [get_attachment] The path in AIDrive to save the attachment. Default: /gmail_attachments/ (string) |
+| `--to` | No | [send] Email address(es) of the recipient(s). For multiple recipients, separate with commas. \| [forward] Email address(es) of the recipient(s). For multiple recipients, separate with commas. (string) |
+| `--subject` | No | [send] The email subject line (string) |
+| `--body` | No | [send] The email body content. **IMPORTANT**: The format of this field MUST match the content_type parameter: - If content_type='text/plain': Use plain text - If content_type='text/html': Use HTML format with tags like <h1>, <p>, <ul>, <li>, etc. **Note**: Email clients DO NOT support Markdown rendering. If you have Markdown content and want formatted display, you must convert it to HTML and set content_type='text/html'. \| [reply] The reply message body. **IMPORTANT**: The format of this field MUST match the content_type parameter: - If content_type='text/plain': Use plain text - If content_type='text/html': Use HTML format with tags like <h1>, <p>, <ul>, <li>, etc. **Note**: Email clients DO NOT support Markdown rendering. If you have Markdown content and want formatted display, you must convert it to HTML and set content_type='text/html'. \| [forward] Optional: Additional message to include above the forwarded content. This is your personal note to the recipients. (string) |
+| `--cc` | No | [send] Optional: CC email address(es). For multiple recipients, separate with commas. \| [forward] Optional: CC email address(es). For multiple recipients, separate with commas. (string) |
+| `--bcc` | No | [send] Optional: BCC email address(es). For multiple recipients, separate with commas. (string) |
+| `--content_type` | No | [send] Content type of the email body. Default: text/html (recommended) **CRITICAL**: This parameter defines the format of the 'body' field: - 'text/plain': body should be plain text only - 'text/html': body MUST be valid HTML (e.g., '<h1>Title</h1><p>Content</p>') **Common mistake**: Setting content_type='text/html' but providing Markdown text (# Title, **bold**). This will display raw Markdown symbols in the email. Always convert Markdown to HTML before passing to this tool. \| [reply] Content type of the reply body. Default: text/html (recommended) **CRITICAL**: This parameter defines the format of the 'body' field: - 'text/plain': body should be plain text only - 'text/html': body MUST be valid HTML (e.g., '<h1>Title</h1><p>Content</p>') **Common mistake**: Setting content_type='text/html' but providing Markdown text. This will display raw Markdown symbols. Always convert Markdown to HTML first. \| [forward] Content type of the body. Default: text/html (recommended) **CRITICAL**: This parameter defines the format of the 'body' field: - 'text/plain': body should be plain text only - 'text/html': body MUST be valid HTML (e.g., '<h1>Title</h1><p>Content</p>') **Common mistake**: Setting content_type='text/html' but providing Markdown text. This will display raw Markdown symbols. Always convert Markdown to HTML first. (string, one of: text/plain, text/html) |
+| `--from_address` | No | [send] Send-as email address to use as the sender. Use this to send as a group/alias address (e.g., 'feedback@company.com'). Must be configured in Gmail's 'Send mail as' settings. \| [reply] Send-as email address to use as the sender. Use this to reply as a group/alias address (e.g., 'feedback@company.com'). Must be configured in Gmail's 'Send mail as' settings. \| [forward] Send-as email address to use as the sender. Use this to forward as a group/alias address. Must be configured in Gmail's 'Send mail as' settings. (string) |
+| `--skip_confirmation` | No | [send] If true, skip user confirmation and send immediately. Default is false (require confirmation before sending). \| [reply] If true, skip user confirmation and send immediately. Default is false (require confirmation before sending). \| [forward] If true, skip user confirmation and send immediately. Default is false (require confirmation before sending). \| [delete] If true, skip user confirmation and delete immediately. Default is false (require confirmation before deleting). \| [move] If true, skip user confirmation and move immediately. Default is false (require confirmation before moving). (boolean, default: `False`) |
+| `--auto_skip_confirmation` | No | [send] Set to true ONLY if the workflow step has [AUTO_SKIP_CONFIRMATION] marker. This indicates the node is configured to always skip confirmation. \| [reply] Set to true ONLY if the workflow step has [AUTO_SKIP_CONFIRMATION] marker. This indicates the node is configured to always skip confirmation. \| [forward] Set to true ONLY if the workflow step has [AUTO_SKIP_CONFIRMATION] marker. This indicates the node is configured to always skip confirmation. \| [delete] Set to true ONLY if the workflow step has [AUTO_SKIP_CONFIRMATION] marker. This indicates the node is configured to always skip confirmation. \| [move] Set to true ONLY if the workflow step has [AUTO_SKIP_CONFIRMATION] marker. This indicates the node is configured to always skip confirmation. (boolean, default: `False`) |
+| `--message_id` | No | [reply] The Gmail message ID to reply to \| [forward] The Gmail message ID to forward \| [delete] The Gmail message ID to delete \| [archive] The Gmail message ID to archive \| [move] The Gmail message ID to move \| [mark_as_read] (Deprecated, use message_ids) A single Gmail message ID to mark \| [add_label] The Gmail message ID to add label to \| [remove_label] The Gmail message ID to remove label from \| [get_attachment] The Gmail message ID containing the attachment (string) |
+| `--reply_all` | No | [reply] Whether to reply to all recipients (TO and CC). Default: true (reply to all recipients including CC) (boolean) |
+| `--include_attachments` | No | [forward] Whether to include original email attachments in the forward. Default: true (boolean, default: `True`) |
+| `--label_name` | No | [move] The target label name. Use '/' for nested labels (e.g., 'Work/Projects'). The label will be created if it doesn't exist. \| [add_label] The label name to add. Can be a new label or an existing one. \| [remove_label] The label name to remove \| [create_label] The name of the label to create. Use '/' for nested labels (e.g., 'Parent/Child'). (string) |
+| `--remove_from_inbox` | No | [move] Whether to remove the email from INBOX. Default: true (standard 'move' behavior). Set to false to just add the label without removing from inbox. (boolean) |
+| `--create_if_not_exists` | No | [move] Whether to create the label if it doesn't exist. Default: true (boolean) |
+| `--message_ids` | No | [mark_as_read] The Gmail message ID(s) to mark. Can be a single ID string or an array of IDs. |
+| `--is_read` | No | [mark_as_read] Set to true to mark as read, false to mark as unread. Default: true (boolean) |
+| `--label_list_visibility` | No | [create_label] The visibility of the label in the label list. Default: labelShow (string, one of: labelShow, labelShowIfUnread, labelHide) |
+| `--message_list_visibility` | No | [create_label] The visibility of messages with this label. Default: show (string, one of: show, hide) |
+| `--background_color` | No | [create_label] The background color of the label in hex format (e.g., '#16a765'). Optional. (string) |
+| `--text_color` | No | [create_label] The text color of the label in hex format (e.g., '#ffffff'). Optional. (string) |
+| `--filename` | No | [get_attachment] The filename of the attachment to retrieve. Use '*' to get all attachments. (string) |
+| `--save_to_aidrive` | No | [get_attachment] Whether to save the attachment to AIDrive. Default: true (boolean) |
+
+## See Also
+
+- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags

package/skills/gsk-google-calendar/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: gsk-google-calendar
+version: 1.0.0
+description: 'Google Calendar operations. Actions: list, create, delete.'
+metadata:
+  category: general
+  requires:
+    bins:
+    - gsk
+  cliHelp: gsk google_calendar --help
+---
+
+# gsk-google-calendar
+
+**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
+
+Google Calendar operations. Actions: list, create, delete.
+
+## Usage
+
+```bash
+gsk google_calendar [options]
+```
+
+## Flags
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `<action>` (positional) | Yes | Action to perform. 'list': List upcoming calendar events; 'create': Create a new calendar event; 'delete': Delete a calendar event (string, one of: list, create, delete) |
+| `--filter_query` | No | [list] Text to filter calendar events, empty for listing all events (string) |
+| `--time_min` | No | [list] Optional. Start time of the search range (RFC3339 timestamp) (string) |
+| `--time_max` | No | [list] Optional. End time of the search range (RFC3339 timestamp) (string) |
+| `--from_account` | No | [list] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. \| [delete] Optional: Email address of the Gmail account to use. Use this when the user has multiple Gmail accounts connected. If not specified, uses the default Gmail account. (string) |
+| `--summary` | No | [create] The title of the event (string) |
+| `--location` | No | [create] The location of the event (string) |
+| `--description` | No | [create] Description or details of the event. Supports restricted HTML formatting (safe subset rendered via Vue v-html): <a>, <b>, <strong>, <i>, <em>, <u>, <br>, <p>, <ul>, <ol>, <li>, <span>, <img>. Use for links, bold, italics, lists, line breaks, images. (string) |
+| `--time_zone` | No | [create] Time zone for the event (e.g., 'GMT-07:00') (string) |
+| `--time_zone_name` | No | [create] Time zone name for the event (e.g., 'America/Los_Angeles') (string) |
+| `--start_time` | No | [create] Start time of the event in ISO 8601 format, must include correct timezone offset (e.g., 'yyyy-mm-ddThh:mm:ss+hh:mm') (string) |
+| `--end_time` | No | [create] End time of the event in ISO 8601 format, must include correct timezone offset (e.g., 'yyyy-mm-ddThh:mm:ss-hh:mm') (string) |
+| `--attendees` | No | [create] List of email addresses of attendees (array) |
+| `--calendar_id` | No | [create] The calendar identifier. Use 'primary' for the user's primary calendar or provide a specific calendar email address (string) |
+| `--event_id` | No | [create] The event identifier. If the request is to modify an existing event, provide the event_id of the event to be modified. If the request is to create a new event, leave this field empty. \| [delete] The Google Calendar event ID to delete (string) |
+| `--recurrence` | No | [create] Recurrence rules (e.g., ['RRULE:FREQ=DAILY;COUNT=2']) (array) |
+| `--send_notifications` | No | [create] Whether to send email notifications to attendees (boolean) |
+| `--delete_series` | No | [delete] If true and the event is recurring, delete the entire series. If false, only delete the single instance. Default is false. (boolean, default: `False`) |
+
+## See Also
+
+- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags

package/skills/gsk-google-contacts/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: gsk-google-contacts
+version: 1.0.0
+description: 'Google Contacts operations. Actions: search, get, create, update.'
+metadata:
+  category: general
+  requires:
+    bins:
+    - gsk
+  cliHelp: gsk contacts --help
+---
+
+# gsk-google-contacts
+
+**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
+
+Google Contacts operations. Actions: search, get, create, update.
+
+## Usage
+
+```bash
+gsk contacts [options]
+```
+
+**Aliases:** `contacts`
+
+## Flags
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `<action>` (positional) | Yes | Action to perform. 'search': Search contacts by name, email, or phone; 'get': Get details of a specific contact; 'create': Create a new contact; 'update': Update an existing contact (string, one of: search, get, create, update) |
+| `--query` | No | [search] Search query to find contacts. Searches across names, email addresses, phone numbers, and notes. (string) |
+| `--limit` | No | [search] Maximum number of results to return (1-100). Default: 20 (integer) |
+| `--account_id` | No | [search] Optional. The Gmail account ID to search (e.g., 'gmail-user@example.com'). If not provided, uses the default Gmail account. \| [get] Optional. The Gmail account ID (e.g., 'gmail-user@example.com'). If not provided, uses the default Gmail account. \| [create] Optional. The Gmail account ID (e.g., 'gmail-user@example.com'). If not provided, uses the default Gmail account. \| [update] Optional. The Gmail account ID (e.g., 'gmail-user@example.com'). If not provided, uses the default Gmail account. (string) |
+| `--resource_name` | No | [get] The resource name of the contact to retrieve (e.g., 'people/c123456789'). This is returned from search results. \| [update] The resource name of the contact to update (e.g., 'people/c123456789'). Required. (string) |
+| `--given_name` | No | [create] First name of the contact. \| [update] First name of the contact. (string) |
+| `--family_name` | No | [create] Last name of the contact. \| [update] Last name of the contact. (string) |
+| `--middle_name` | No | [create] Middle name of the contact. \| [update] Middle name of the contact. (string) |
+| `--emails` | No | [create] List of email addresses. Each with 'value' and optional 'type' (home/work/other). \| [update] List of email addresses. Replaces all existing emails. (array) |
+| `--phones` | No | [create] List of phone numbers. Each with 'value' and optional 'type' (home/work/mobile/other). \| [update] List of phone numbers. Replaces all existing phones. (array) |
+| `--organization` | No | [create] Company or organization name. \| [update] Company or organization name. (string) |
+| `--job_title` | No | [create] Job title at the organization. \| [update] Job title at the organization. (string) |
+| `--department` | No | [create] Department at the organization. \| [update] Department at the organization. (string) |
+| `--addresses` | No | [create] List of addresses with street, city, region, postal_code, country. \| [update] List of addresses. Replaces all existing addresses. (array) |
+| `--birthday` | No | [create] Birthday with year (optional), month, and day. \| [update] Birthday with year (optional), month, and day. (object) |
+| `--notes` | No | [create] Notes or biography for the contact. \| [update] Notes or biography for the contact. (string) |
+| `--urls` | No | [create] List of URLs (websites, social profiles, etc.). \| [update] List of URLs. Replaces all existing URLs. (array) |
+
+## See Also
+
+- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags

package/skills/gsk-google-docs/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: gsk-google-docs
+version: 1.0.0
+description: 'Google Docs document operations. Actions: create, read, append, search.'
+metadata:
+  category: general
+  requires:
+    bins:
+    - gsk
+  cliHelp: gsk docs --help
+---
+
+# gsk-google-docs
+
+**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
+
+Google Docs document operations. Actions: create, read, append, search.
+
+## Usage
+
+```bash
+gsk docs [options]
+```
+
+**Aliases:** `docs`
+
+## Flags
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `<action>` (positional) | Yes | Action to perform. 'create': Create a new document; 'read': Read content from a document; 'append': Append content to a document; 'search': Search documents by name (string, one of: create, read, append, search) |
+| `--title` | No | [create] Title of the new document. (string) |
+| `--content` | No | [create] Optional initial text content for the document. \| [append] The text content to append to the document. (string) |
+| `--document_id` | No | [read] The ID of the document to read. \| [append] The ID of the document to append to. (string) |
+| `--query` | No | [search] Search query to find documents by name or content. (string) |
+| `--limit` | No | [search] Maximum number of results to return (1-50). Default: 10 (integer) |
+
+## See Also
+
+- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags

package/skills/gsk-google-drive/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: gsk-google-drive
+version: 1.0.0
+description: 'Google Drive file operations. Actions: search, read, upload.'
+metadata:
+  category: general
+  requires:
+    bins:
+    - gsk
+  cliHelp: gsk gdrive --help
+---
+
+# gsk-google-drive
+
+**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
+
+Google Drive file operations. Actions: search, read, upload.
+
+## Usage
+
+```bash
+gsk gdrive [options]
+```
+
+**Aliases:** `gdrive`
+
+## Flags
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `<action>` (positional) | Yes | Action to perform. 'search': Search files by name, type, or owner; 'read': Read and extract content from a file; 'upload': Upload a file to Google Drive (string, one of: search, read, upload) |
+| `--query` | No | [search] Use keywords simply, terms will be combined into advanced search query in the later process.For example, if user ask for 'tax related documents', just use 'tax' as the query,DO NOT use advanced search query like 'name contains 'tax'' or 'fullText contains 'tax''. (string) |
+| `--mime_type` | No | [search] Filter by MIME type for 'search' (e.g., 'application/pdf'). \| [upload] The MIME type of the file (optional, will be auto-detected from file_name extension). Examples: 'text/plain', 'text/csv', 'application/json', 'image/png'. (string) |
+| `--owner` | No | [search] Filter by file owner (email address) for 'search' action (string) |
+| `--folder_id` | No | [search] Search within a specific folder for 'search' action \| [upload] Google Drive folder ID to upload to. Optional, uploads to root if not specified. (string) |
+| `--trashed` | No | [search] Include trashed files in search results for 'search' action (boolean) |
+| `--file_id` | No | [read] The ID of the file to read from Google Drive. (string) |
+| `--question` | No | [read] The question to answer about the file content. (string) |
+| `--content` | No | [upload] Text content to create as a file. Use this for creating text-based files (e.g., .txt, .md, .csv, .json, .html). Either 'content' or 'file_path' is required. (string) |
+| `--file_path` | No | [upload] Local file path to upload. Either 'content' or 'file_path' is required. (string) |
+| `--file_name` | No | [upload] File name in Google Drive (include extension, e.g., 'report.txt'). MIME type will be auto-detected from extension if not specified. (string) |
+| `--convert_to_google_format` | No | [upload] Whether to convert to Google Workspace format (e.g., .docx → Google Docs, .xlsx → Google Sheets, .pptx → Google Slides). Default: false (boolean, default: `False`) |
+| `--share_publicly` | No | [upload] Whether to share the file publicly for viewing. Default: false (boolean, default: `False`) |
+
+## See Also
+
+- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags

package/skills/gsk-google-sheets/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: gsk-google-sheets
+version: 1.0.0
+description: 'Google Sheets spreadsheet operations. Actions: create, read, write,
+  append, search, export.'
+metadata:
+  category: general
+  requires:
+    bins:
+    - gsk
+  cliHelp: gsk sheets --help
+---
+
+# gsk-google-sheets
+
+**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
+
+Google Sheets spreadsheet operations. Actions: create, read, write, append, search, export.
+
+## Usage
+
+```bash
+gsk sheets [options]
+```
+
+**Aliases:** `sheets`
+
+## Flags
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `<action>` (positional) | Yes | Action to perform. 'create': Create a new spreadsheet; 'read': Read data from a spreadsheet; 'write': Write data to a specific range; 'append': Append rows to a spreadsheet; 'search': Search spreadsheets by name; 'export': Export a spreadsheet to CSV or other format (string, one of: create, read, write, append, search, export) |
+| `--title` | No | [create] Title of the new spreadsheet. (string) |
+| `--sheet_names` | No | [create] Names of sheets to create. Default: ['Sheet1'] (array) |
+| `--initial_data` | No | [create] Optional initial data for the first sheet. 2D array where each inner array is a row. (array) |
+| `--spreadsheet_id` | No | [read] The ID of the spreadsheet to read from. \| [write] The ID of the spreadsheet to write to. \| [append] The ID of the spreadsheet to append to. \| [export] The ID of the Google Sheets spreadsheet to export. (string) |
+| `--range` | No | [read] The A1 notation range to read (e.g., 'Sheet1!A1:D10', 'A1:B5'). Default: reads first sheet entirely. \| [write] The A1 notation range to write to (e.g., 'Sheet1!A1:D10'). The range should match the size of the data. \| [append] The A1 notation of a range to search for data table. New rows will be appended after the last row in this table. Example: 'Sheet1!A:D' or 'Sheet1' (string) |
+| `--values` | No | [write] 2D array of values to write. Each inner array is a row. Example: [['Name', 'Age'], ['Alice', '30'], ['Bob', '25']] \| [append] 2D array of values to append. Each inner array is a row. Example: [['Alice', '30'], ['Bob', '25']] (array) |
+| `--query` | No | [search] Search query to find spreadsheets by name or content. (string) |
+| `--limit` | No | [search] Maximum number of results to return (1-50). Default: 10 (integer) |
+| `--filename` | No | [export] Optional custom filename for the exported file (without extension). If not provided, the original spreadsheet name will be used. (string) |
+
+## See Also
+
+- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags

package/skills/gsk-image-generation/SKILL.md

@@ -28,7 +28,7 @@ gsk img [options]
 
 | Flag | Required | Description |
 |------|----------|-------------|
-| `-m`, `--model` | No | Default model: use nano-banana-2 fal-ai/gpt-image-1.5: GPT Image 1.5 - Supports text-to-image and image editing with multi-image input. nano-banana-pro: [GEMINI NANO BANANA PRO] State of the Art (SOTA) for both generation and image editing. Multi-image fusion: Combine different images into one seamless new visual. Character & style consistency: Maintain the same subject or visual style across multiple generations. Conversational editing: Edit images with simple, natural language instructions. Perfect for creative use cases, marketing, training, advertising. Supports up to 14 images as reference input. Supports high resolution output up to 2K/4K. nano-banana-2: [GEMINI NANO BANANA 2] Gemini 3.1 Flash Image. Fast and efficient with advanced reasoning. Multi-image fusion with up to 14 reference images. Supports 0.5K/1K/2K/4K resolution. Google Search grounding for real-time data. Best for high-volume, speed-optimized workflows. imagen4: A latest model for generating high quality image, upgrade from Imagen 3. currently in preview mode.recraft-v3: A model for generating realistic image.fal-ai/bytedance/seedream/v5/lite: Bytedance Seedream v5 Lite model for text-to-image, image-to-image (single and multiple image editing) generation with native 2K resolution and excellent text layout.fal-ai/flux-2: Flux 2 model for text-to-image and image editing with enhanced realism, crisp text generation, and native editing capabilities. Fast processing with flexible aspect ratios. Supports up to 3 images for edit mode.fal-ai/flux-2-pro: Flux 2 Pro model - higher quality version of Flux 2 with professional-grade output. Enhanced realism, superior text generation, and advanced editing capabilities. Ideal for high-quality realistic images and complex editing tasks.fal-ai/z-image/turbo: Z-Image Turbo model optimized for speed without sacrificing quality. Supports both text-to-image and image-to-image modes. Perfect for quick iterations, bulk generation, style transfer, and cost-effective projects.ideogram/V_3: [FACE CONSISTENCY] Character reference specialist with superior facial feature preservation, character consistency across styles/poses/scenes, natural language understanding, excellent text rendering.qwen-image: [CHINESE POSTER SPECIALIST] Outstanding Chinese poster creation, superior Chinese text rendering, cultural context mastery, exceptional Chinese understanding, cost efficient.bbox-segment: A model for extracting subjects from images based on bbox region.fal-bria-rmbg: A model specialized for remove background from image. Should prioritize this tool if the user wants to remove background from image. fal-ai/recraft-clarity-upscale: A model specialized for upscale image. fal-ai/image-editing/text-removal: A specialized model for removing text and watermarks from images. Automatically detects and removes text while preserving the background and other visual elements. Use when users want to clean images, remove watermarks, or eliminate text overlays. flux-pro/outpaint: A model specialized for expand image to a specific aspect ratio.  (string, one of: fal-ai/gpt-image-1.5, imagen4, recraft-v3, fal-ai/bytedance/seedream/v5/lite, fal-ai/flux-2, fal-ai/flux-2-pro, fal-ai/z-image/turbo, ideogram/V_3, qwen-image, bbox-segment, fal-bria-rmbg, fal-ai/recraft-clarity-upscale, fal-ai/image-editing/text-removal, flux-pro/outpaint, nano-banana-pro, nano-banana-2) |
+| `-m`, `--model` | No | Default model: use nano-banana-2 gpt-image-2: GPT Image 2 - Latest OpenAI image model. Superior text rendering, editing, and face preservation. Supports text-to-image and image editing with multi-image input. nano-banana-pro: [GEMINI NANO BANANA PRO] State of the Art (SOTA) for both generation and image editing. Multi-image fusion: Combine different images into one seamless new visual. Character & style consistency: Maintain the same subject or visual style across multiple generations. Conversational editing: Edit images with simple, natural language instructions. Perfect for creative use cases, marketing, training, advertising. Supports up to 14 images as reference input. Supports high resolution output up to 2K/4K. nano-banana-2: [GEMINI NANO BANANA 2] Gemini 3.1 Flash Image. Fast and efficient with advanced reasoning. Multi-image fusion with up to 14 reference images. Supports 0.5K/1K/2K/4K resolution. Google Search grounding for real-time data. Best for high-volume, speed-optimized workflows. imagen4: A latest model for generating high quality image, upgrade from Imagen 3. currently in preview mode.recraft-v3: A model for generating realistic image.fal-ai/bytedance/seedream/v5/lite: Bytedance Seedream v5 Lite model for text-to-image, image-to-image (single and multiple image editing) generation with native 2K resolution and excellent text layout.fal-ai/flux-2: Flux 2 model for text-to-image and image editing with enhanced realism, crisp text generation, and native editing capabilities. Fast processing with flexible aspect ratios. Supports up to 3 images for edit mode.fal-ai/flux-2-pro: Flux 2 Pro model - higher quality version of Flux 2 with professional-grade output. Enhanced realism, superior text generation, and advanced editing capabilities. Ideal for high-quality realistic images and complex editing tasks.fal-ai/z-image/turbo: Z-Image Turbo model optimized for speed without sacrificing quality. Supports both text-to-image and image-to-image modes. Perfect for quick iterations, bulk generation, style transfer, and cost-effective projects.ideogram/V_3: [FACE CONSISTENCY] Character reference specialist with superior facial feature preservation, character consistency across styles/poses/scenes, natural language understanding, excellent text rendering.qwen-image: [CHINESE POSTER SPECIALIST] Outstanding Chinese poster creation, superior Chinese text rendering, cultural context mastery, exceptional Chinese understanding, cost efficient.bbox-segment: A model for extracting subjects from images based on bbox region.fal-bria-rmbg: A model specialized for remove background from image. Should prioritize this tool if the user wants to remove background from image. fal-ai/recraft-clarity-upscale: A model specialized for upscale image. fal-ai/image-editing/text-removal: A specialized model for removing text and watermarks from images. Automatically detects and removes text while preserving the background and other visual elements. Use when users want to clean images, remove watermarks, or eliminate text overlays. flux-pro/outpaint: A model specialized for expand image to a specific aspect ratio.  (string, one of: gpt-image-2, nano-banana-pro, nano-banana-2, imagen4, recraft-v3, fal-ai/bytedance/seedream/v5/lite, fal-ai/flux-2, fal-ai/flux-2-pro, fal-ai/z-image/turbo, ideogram/V_3, qwen-image, bbox-segment, fal-bria-rmbg, fal-ai/recraft-clarity-upscale, fal-ai/image-editing/text-removal, flux-pro/outpaint) |
 | `<query>` (positional) | Yes | Detailed description of the image to generate. The prompt should be in English.However, any specific text that should appear within the image does not need to be translated.(e.g., 'A futuristic cityscape with flying cars and neon lights at night'). (string) |
 | `--bbox` | No | BBox of the target object, for bbox segmentation modelFormat: [x1, y1, x2, y2], x1 and y1 are the top-left corner coordinates, x2 and y2 are the bottom-right corner coordinates. (array) |
 | `-i`, `--image_urls` | No | The URLs of the images to use as a reference for the image generation or editing. (default is [], if the task is based on one or more reference images, it is required) (array) |

package/skills/gsk-meeting/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: gsk-meeting
+version: 1.0.0
+description: 'Meeting notes operations. Actions: list, search, get.'
+metadata:
+  category: general
+  requires:
+    bins:
+    - gsk
+  cliHelp: gsk meeting --help
+---
+
+# gsk-meeting
+
+**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
+
+Meeting notes operations. Actions: list, search, get.
+
+## Usage
+
+```bash
+gsk meeting [options]
+```
+
+## Flags
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `<action>` (positional) | Yes | Action to perform. 'list': List meeting notes by creation date; 'search': Search meeting notes by keyword; 'get': Get details of a specific meeting note (string, one of: list, search, get) |
+| `--page_size` | No | [list] Number of results per page. Default: 20. Max: 50. \| [search] Number of results per page. Default: 20. Max: 50. (integer) |
+| `--continuation_token` | No | [list] Token for fetching the next page of results. Returned from a previous list call. (string) |
+| `--keyword` | No | [search] Search term to find in meeting notes. (string) |
+| `--date_from` | No | [search] Filter meetings after this date (ISO format: YYYY-MM-DD). (string) |
+| `--date_to` | No | [search] Filter meetings before this date (ISO format: YYYY-MM-DD). (string) |
+| `--meeting_source` | No | [search] Filter by calendar source. (string, one of: google, outlook) |
+| `--sort_by` | No | [search] Sort order. 'relevance' for best match first, 'created_at' for newest first (default). (string, one of: created_at, relevance) |
+| `--page` | No | [search] Page number (0-indexed). Use with has_more to paginate results. Default: 0. (integer) |
+| `--task_id` | No | [get] The ID of the meeting note to retrieve. (string) |
+| `--detail_level` | No | [get] Level of detail to return. 'summary' = title + status + summary + user notes (default, saves tokens). 'full' = summary + complete transcription text. 'segments' = summary + segments with speaker labels. (string, one of: summary, full, segments) |
+
+## See Also
+
+- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags

package/skills/gsk-microsoft-teams/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: gsk-microsoft-teams
+version: 1.0.0
+description: 'Microsoft Teams operations. Actions: send, list_channels, list_chats,
+  list_teams, search, search_users, create_chat.'
+metadata:
+  category: general
+  requires:
+    bins:
+    - gsk
+  cliHelp: gsk teams --help
+---
+
+# gsk-microsoft-teams
+
+**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
+
+Microsoft Teams operations. Actions: send, list_channels, list_chats, list_teams, search, search_users, create_chat.
+
+## Usage
+
+```bash
+gsk teams [options]
+```
+
+**Aliases:** `teams`
+
+## Flags
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `<action>` (positional) | Yes | Action to perform. 'send': Send a message in Teams; 'list_channels': List channels in a team; 'list_chats': List recent chats; 'list_teams': List teams the user belongs to; 'search': Search messages; 'search_users': Search for users; 'create_chat': Create a new chat (string, one of: send, list_channels, list_chats, list_teams, search, search_users, create_chat) |
+| `--content` | No | [send] The message content to send. Supports HTML formatting including clickable links. Use <a href='URL'>text</a> for links, <b>text</b> for bold, <i>text</i> for italic, <br> for line breaks, and other standard HTML tags. (string) |
+| `--chat_id` | No | [send] Optional chat ID to send the message to. If not specified or set to 'self', sends to yourself as a DM. Use chat IDs from microsoft_teams_search_messages results. (string) |
+| `--channel_type` | No | [send] Type of channel: 'teams_chat' for 1:1 or group chats, 'teams_channel' for team channels. Default: 'teams_chat' (string, one of: teams_chat, teams_channel) |
+| `--team_id` | No | [send] Required if channel_type is 'teams_channel'. The team ID where the channel belongs. \| [list_channels] The ID of the team to list channels for. (string) |
+| `--channel_id` | No | [send] Required if channel_type is 'teams_channel'. The channel ID within the team. (string) |
+| `--importance` | No | [send] Message importance level that controls notification behavior. 'normal': Regular message, no special notification (default). 'high': Triggers notification without special emphasis. 'urgent': Triggers immediate notification with sound and alert. Default: 'normal' (string, one of: normal, high, urgent) |
+| `--notify` | No | [send] Whether to force notification by @mentioning yourself in the message. When true, adds a self-mention to ensure notification is triggered. Useful when sending reminders to yourself. Default: true (boolean) |
+| `--mention_user_ids` | No | [send] List of user IDs (GUIDs) to @mention in the message. Use search_users to find user IDs first. The message content should include {mention_N} placeholders where N is the index (0-based), e.g., '{mention_0} thank you' will @mention the first user in the list. (array) |
+| `--mention_user_names` | No | [send] Display names for mentioned users, in same order as mention_user_ids. If not provided, will use user IDs as display names. (array) |
+| `--topic` | No | [list_chats] Search for chats by topic/name (case-insensitive partial match). Use this to find a specific group chat by its name. Example: 'WorkflowTest' to find a chat with that topic. \| [create_chat] Topic/name for the group chat. Required for group chats (2+ members), ignored for 1:1 chats. (string) |
+| `--chat_type` | No | [list_chats] Filter by chat type. 'oneOnOne' for 1:1 chats, 'group' for group chats, 'meeting' for meeting chats, 'all' for all types. Default: 'all' (string, one of: oneOnOne, group, meeting, all) |
+| `--count` | No | [list_chats] Maximum number of chats to return. Default: 50 \| [list_teams] Maximum number of teams to return. Default: 50 \| [search] The maximum number of messages to return. Default is 100. \| [search_users] Maximum number of users to return. Default: 10 (integer) |
+| `--query` | No | [search] The search query using KQL (Keyword Query Language). **Query Behavior**: • Spaces = AND: 'project meeting' finds messages with BOTH terms • OR operator: 'project OR meeting' finds messages with EITHER term • KQL modifiers: 'from:john', 'hasAttachment:true', 'sent>2024-01-01', 'IsRead:false' • Examples: 'urgent project', 'bug OR issue', 'from:alice budget', 'hasAttachment:true report' \| [search_users] Search query - can be a name, email, or partial match. Example: 'John', 'john@company.com', 'Smith' (string) |
+| `--unread_only` | No | [search] Set to true to search for unread messages only. Default is false. (boolean) |
+| `--question` | No | [search] A specific question to answer based on the search results. (string) |
+| `--include_chat_id` | No | [search_users] If true, also return the chat_id for existing 1:1 chats with each user. This allows direct messaging without create_chat. Default: true (boolean) |
+| `--member_emails` | No | [create_chat] List of email addresses of users to add to the chat. One email for 1:1 chat, multiple for group chat. (array) |
+
+## See Also
+
+- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags

package/skills/gsk-notion/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: gsk-notion
+version: 1.0.0
+description: 'Notion page operations. Actions: search, read, create.'
+metadata:
+  category: general
+  requires:
+    bins:
+    - gsk
+  cliHelp: gsk notion --help
+---
+
+# gsk-notion
+
+**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
+
+Notion page operations. Actions: search, read, create.
+
+## Usage
+
+```bash
+gsk notion [options]
+```
+
+## Flags
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `<action>` (positional) | Yes | Action to perform. 'search': Search pages and databases; 'read': Read content from a page; 'create': Create a new page (string, one of: search, read, create) |
+| `--query` | No | [search] Query to search for in Notion pages. (string) |
+| `--page_id` | No | [read] The ID of the Notion page to read and summarize. (string) |
+| `--title` | No | [create] The title of the new page. (string) |
+| `--content` | No | [create] The content of the page in markdown format. Supports headings, lists, code blocks, links, etc. (string) |
+| `--parent_id` | No | [create] The ID of the parent page or database where the new page will be created. Use notion_search to find available pages/databases first. (string) |
+| `--parent_type` | No | [create] The type of parent: 'page_id' for creating under a page, 'database_id' for creating in a database. Default is 'page_id'. (string, one of: page_id, database_id) |
+
+## See Also
+
+- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags