@genspark/cli 1.0.7 → 1.0.8

package/skills/gsk-meeting-search/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: gsk-meeting-search
+version: 1.0.0
+description: Search meeting notes by keyword using full-text search.
+metadata:
+  category: meeting
+  requires:
+    bins:
+    - gsk
+  cliHelp: gsk meeting search --help
+---
+
+# gsk-meeting-search
+
+**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
+
+Search meeting notes by keyword using full-text search.
+
+## Usage
+
+```bash
+gsk meeting search [options]
+```
+
+## Flags
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `<keyword>` (positional) | Yes | Search term to find in meeting notes. (string) |
+| `--date_from` | No | Filter meetings after this date (ISO format: YYYY-MM-DD). (string) |
+| `--date_to` | No | Filter meetings before this date (ISO format: YYYY-MM-DD). (string) |
+| `--meeting_source` | No | Filter by calendar source. (string, one of: google, outlook) |
+| `-n`, `--page_size` | No | Number of results per page. Default: 20. Max: 50. (integer) |
+| `-s`, `--sort_by` | No | Sort order. 'relevance' for best match first, 'created_at' for newest first (default). (string, one of: created_at, relevance) |
+| `--page` | No | Page number (0-indexed). Use with has_more to paginate results. Default: 0. (integer) |
+
+## See Also
+
+- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags

package/skills/gsk-phone-call/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: gsk-phone-call
+version: 1.0.0
+description: Create an AI phone call card. Validates user prerequisites (membership,
+  phone setup, credits) and resolves contact information. For business contacts, looks
+  up Google Maps place data. For personal contacts, validates and normalizes the phone
+  number.
+metadata:
+  category: general
+  requires:
+    bins:
+    - gsk
+  cliHelp: gsk phone_call --help
+---
+
+# gsk-phone-call
+
+**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
+
+Create an AI phone call card. Validates user prerequisites (membership, phone setup, credits) and resolves contact information. For business contacts, looks up Google Maps place data. For personal contacts, validates and normalizes the phone number.
+
+## Usage
+
+```bash
+gsk phone_call [options]
+```
+
+## Flags
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `<recipient>` (positional) | Yes | The name of the person or business to call. Examples: - Personal: 'John Smith', 'Dr. Sarah Johnson' - Business: 'Starbucks George Street', 'Hilton Hotel Downtown' (string) |
+| `-c`, `--contact_info` | Yes | Contact information - either a Google Maps place_id OR a phone number:  **For businesses (is_place_id=true):** - Provide Google Maps place_id (e.g., 'ChIJcawkWTyuEmsRG56o5LAc0LQ') - Must be obtained from previous maps_search results - NEVER fabricate or guess place_id values  **For personal contacts (is_place_id=false):** - Provide phone number with international country code - Format: '+1-555-123-4567' (US), '+44-20-1234-5678' (UK) - If no country code, defaults to US (+1) - MUST have verified data lineage from: (1) user-provided info, (2) previous tool results, or (3) explicit context - NEVER fabricate, generate, estimate, or infer phone numbers (string) |
+| `--is_place_id` | Yes | Indicates the type of contact_info provided: - true: contact_info is a Google Maps place_id (business) - false: contact_info is a phone number (personal contact) (boolean) |
+| `-p`, `--purpose` | Yes | The clear reason for making the call (e.g., 'Check reservation availability', 'Inquire about business hours'). (string) |
+
+> **CAUTION:** This command performs a write/send operation. Double-check parameters before executing.
+
+## See Also
+
+- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags

package/skills/gsk-shared/SKILL.md

@@ -0,0 +1,177 @@
+---
+name: gsk-shared
+version: 1.0.0
+description: "Shared foundation: authentication, global flags, output conventions, and security rules for all GSK CLI skills."
+metadata:
+  category: foundation
+  requires:
+    bins:
+      - gsk
+---
+
+# GSK CLI — Shared Foundation
+
+**PREREQUISITE:** Every GSK skill assumes this document has been read first.
+
+## Installation
+
+```bash
+npm install -g @genspark/cli
+```
+
+Requires Node.js >= 18.
+
+## Authentication
+
+```bash
+# Log in via browser (saves API key to ~/.genspark-tool-cli/config.json)
+gsk login
+
+# Or provide an API key directly
+export GSK_API_KEY="gsk_..."
+
+# Check current identity
+gsk me
+```
+
+## Global Flags
+
+| Flag | Env Var | Default | Description |
+|------|---------|---------|-------------|
+| `--api-key <key>` | `GSK_API_KEY` | — | API key (required) |
+| `--base-url <url>` | `GSK_BASE_URL` | `https://www.genspark.ai` | API base URL |
+| `--project-id <id>` | `GSK_PROJECT_ID` | — | Project ID for access control |
+| `--debug` | — | `false` | Enable debug output |
+| `--timeout <ms>` | — | `300000` | Request timeout (5 min default) |
+| `--output <format>` | — | `json` | Output format: `json` or `text` |
+| `--refresh` | — | — | Force refresh cached tool schemas |
+
+## Output Conventions
+
+| Stream | Content | Consumer |
+|--------|---------|----------|
+| **stdout** | JSON result | Programs / AI agents |
+| **stderr** | Progress, debug, error messages | Human / logs |
+
+Always parse stdout as JSON. Use `--output text` for human-readable output.
+
+## Local File Handling
+
+Most commands that accept URLs also accept local file paths. The CLI automatically uploads local files before passing them to the API:
+
+```bash
+gsk analyze "Describe this" -i ./photo.jpg
+gsk img "Enhance this" -i ./photo.png -o ./result.png
+```
+
+Use `-o` / `--output-file` to save generated results directly to a local file.
+
+## Configuration Priority
+
+1. **CLI options** (highest)
+2. **Environment variables**
+3. **Config file** (`~/.genspark-tool-cli/config.json`)
+
+## Security Rules
+
+- Never expose your API key in shared scripts or logs.
+- Use `--project-id` for access control when sharing resources.
+- The CLI auto-updates every 4 hours. Disable with `GSK_NO_AUTO_UPDATE=1`.
+
+## Built-in Commands
+
+These commands are implemented in the CLI frontend and have no backend adaptor.
+
+### list-tools
+
+List all available tools.
+
+```bash
+gsk list-tools    # or: gsk ls
+```
+
+### upload
+
+Upload a local file and get a file wrapper URL for use in other commands.
+
+```bash
+gsk upload ./image.png
+gsk upload ./document.pdf
+```
+
+Returns a JSON object with `upload_url` and `file_wrapper_url`.
+
+### download
+
+Download a file from a file wrapper URL.
+
+```bash
+# Get download URL only
+gsk download "/api/files/s/abc123"
+
+# Download and save to local file
+gsk download "/api/files/s/abc123" -s ./downloaded.png
+```
+
+| Flag | Description |
+|------|-------------|
+| `-s, --save <path>` | Download and save to local file path |
+
+### init-opencode
+
+Generate an `.opencode.json` config file for [OpenCode](https://opencode.ai), pre-configured to use Genspark's LLM proxy.
+
+```bash
+gsk init-opencode
+gsk init-opencode --model claude-sonnet-4-6
+gsk init-opencode -o ./my-project/.opencode.json
+```
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--model <name>` | `claude-opus-4-6-1m` | Default model for OpenCode |
+| `-o, --out <path>` | `.opencode.json` | Output file path |
+
+### init-skills
+
+Sync GSK skill documents into the current project for AI agent discovery. Generates a `CONTEXT.md` entry point and optionally agent-specific config files.
+
+```bash
+# Copy skills to .gsk/skills/ and generate CONTEXT.md
+gsk init-skills
+
+# Also generate .claude/ config for Claude Code
+gsk init-skills --agent claude
+
+# Generate config for all supported agents
+gsk init-skills --agent all
+
+# Custom output directory
+gsk init-skills -o ./docs/gsk-skills
+```
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `-o, --out <dir>` | `.gsk/skills` | Output directory for skills |
+| `--agent <type>` | — | Generate agent config: `claude`, `gemini`, or `all` |
+
+**Generated files:**
+- `CONTEXT.md` — Universal agent entry point listing all available skills
+- `.claude/settings.json` — Claude Code context includes (when `--agent claude`)
+- `gemini-extension.json` — Gemini extension config (when `--agent gemini`)
+
+### AI Drive: local file upload
+
+The `gsk drive upload` command supports streaming local files directly to AI Drive via `--local_file`. This is a CLI-only feature (not in the backend API).
+
+```bash
+# Upload a local file to AI Drive (streaming, supports 100MB+ files)
+gsk drive upload --local_file ./report.pdf --upload_path /docs/report.pdf
+gsk drive upload --local_file ./photo.png              # defaults to /photo.png
+gsk drive upload --local_file ./doc.pdf --upload_path /docs/doc.pdf --override
+```
+
+| Flag | Description |
+|------|-------------|
+| `--local_file <path>` | Local file path to upload (streaming, no size limit) |
+| `--override` | Overwrite existing file at the destination path |

package/skills/gsk-social-instagram/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: gsk-social-instagram
+version: 1.0.0
+description: 'Search and retrieve data from Instagram: posts, users, comments, and
+  connections.'
+metadata:
+  category: social
+  requires:
+    bins:
+    - gsk
+  cliHelp: gsk social instagram --help
+---
+
+# gsk-social-instagram
+
+**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
+
+Search and retrieve data from Instagram: posts, users, comments, and connections.
+
+## Usage
+
+```bash
+gsk social instagram [options]
+```
+
+## Flags
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `<action>` (positional) | Yes | The action to perform. (string, one of: search_posts, search_users, get_posts_by_user, get_posts_by_ids, get_user, get_user_connections, get_users_by_keywords, get_comments, get_post_interacting_users) |
+| `-q`, `--query` | No | Search query or username/identifier. Used by: search_posts, search_users (as name), get_posts_by_user (as identifier), get_user (as identifier), get_users_by_keywords. (string) |
+| `-p`, `--post_id` | No | Post ID. Used by: get_comments, get_post_interacting_users. (string) |
+| `--post_ids` | No | Comma-separated post IDs. Used by: get_posts_by_ids. (string) |
+| `--connection_type` | No | Connection type for get_user_connections. (string, one of: followers, following) |
+| `--interaction_type` | No | Interaction type for get_post_interacting_users. (string, one of: likers, commenters) |
+| `--start_date` | No | Start date filter (YYYY-MM-DD). (string) |
+| `--end_date` | No | End date filter (YYYY-MM-DD). (string) |
+| `--limit` | No | Max number of results (for search_users). (integer) |
+
+## See Also
+
+- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags

package/skills/gsk-social-reddit/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: gsk-social-reddit
+version: 1.0.0
+description: 'Search and retrieve data from Reddit: posts, comments, users, and subreddits.'
+metadata:
+  category: social
+  requires:
+    bins:
+    - gsk
+  cliHelp: gsk social reddit --help
+---
+
+# gsk-social-reddit
+
+**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
+
+Search and retrieve data from Reddit: posts, comments, users, and subreddits.
+
+## Usage
+
+```bash
+gsk social reddit [options]
+```
+
+## Flags
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `<action>` (positional) | Yes | The action to perform. (string, one of: search_posts, search_comments, search_users, search_subreddits, get_post_with_comments, get_subreddit_with_posts, get_subreddits_by_keywords, get_user, get_users_by_keywords) |
+| `-q`, `--query` | No | Search query string. Used by: search_posts, search_comments, search_users (as name), search_subreddits, get_subreddits_by_keywords, get_user (as username), get_users_by_keywords, get_subreddit_with_posts (as subreddit name), get_post_with_comments (as post_id). (string) |
+| `-p`, `--post_id` | No | Post ID. Used by: get_post_with_comments. (string) |
+| `-s`, `--subreddit` | No | Subreddit name filter for search_posts, search_comments, get_users_by_keywords. (string) |
+| `--sort` | No | Sort order for search_posts. (string, one of: relevance, hot, top, new, comments) |
+| `--time` | No | Time filter for search_posts. (string, one of: hour, day, week, month, year, all) |
+| `--start_date` | No | Start date filter (YYYY-MM-DD). (string) |
+| `--end_date` | No | End date filter (YYYY-MM-DD). (string) |
+| `--limit` | No | Max number of results (for search_users, search_subreddits). (integer) |
+
+## See Also
+
+- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags

package/skills/gsk-social-twitter/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: gsk-social-twitter
+version: 1.0.0
+description: 'Search and retrieve data from Twitter/X: posts, users, comments, retweets,
+  and more.'
+metadata:
+  category: social
+  requires:
+    bins:
+    - gsk
+  cliHelp: gsk social twitter --help
+---
+
+# gsk-social-twitter
+
+**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
+
+Search and retrieve data from Twitter/X: posts, users, comments, retweets, and more.
+
+## Usage
+
+```bash
+gsk social twitter [options]
+```
+
+## Flags
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `<action>` (positional) | Yes | The action to perform. (string, one of: search_posts, search_users, get_posts_by_author, get_posts_by_ids, get_user, get_user_connections, get_users_by_keywords, get_comments, get_quotes, get_retweets, get_post_interacting_users, count_posts) |
+| `-q`, `--query` | No | Search query string. Used by: search_posts, search_users (as name), get_users_by_keywords, get_posts_by_author (as identifier/handle), get_user (as identifier/username), count_posts (as phrase). (string) |
+| `-p`, `--post_id` | No | Tweet/post ID. Used by: get_comments, get_quotes, get_retweets, get_post_interacting_users. (string) |
+| `--post_ids` | No | Comma-separated tweet IDs. Used by: get_posts_by_ids. (string) |
+| `--connection_type` | No | Connection type for get_user_connections. (string, one of: followers, following) |
+| `--interaction_type` | No | Interaction type for get_post_interacting_users. (string, one of: commenters, quoters, retweeters) |
+| `--start_date` | No | Start date filter (YYYY-MM-DD). (string) |
+| `--end_date` | No | End date filter (YYYY-MM-DD). (string) |
+| `--language` | No | Language filter (e.g. 'en', 'zh'). (string) |
+| `--limit` | No | Max number of results (for search_users). (integer) |
+
+## See Also
+
+- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags

package/skills/gsk-stock-price/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: gsk-stock-price
+version: 1.0.0
+description: Retrieve real-time stock price information for a specific company.
+metadata:
+  category: general
+  requires:
+    bins:
+    - gsk
+  cliHelp: gsk stock --help
+---
+
+# gsk-stock-price
+
+**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
+
+Retrieve real-time stock price information for a specific company.
+
+## Usage
+
+```bash
+gsk stock [options]
+```
+
+**Aliases:** `stock_price`, `stock`
+
+## Flags
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `<symbol>` (positional) | Yes | The stock ticker symbol of the company (e.g., 'AAPL' for Apple, 'MSFT' for Microsoft). (string) |
+
+## See Also
+
+- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags

package/skills/gsk-summarize-large-document/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: gsk-summarize-large-document
+version: 1.0.0
+description: Analyze and answer questions about large documents (PDFs, web pages,
+  Word docs, etc.).
+metadata:
+  category: general
+  requires:
+    bins:
+    - gsk
+  cliHelp: gsk summarize --help
+---
+
+# gsk-summarize-large-document
+
+**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
+
+Analyze and answer questions about large documents (PDFs, web pages, Word docs, etc.).
+
+## Usage
+
+```bash
+gsk summarize [options]
+```
+
+**Aliases:** `summarize_large_document`, `summarize`
+
+## Flags
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `<url>` (positional) | Yes | URL of the document to be fetched and analyzed (string) |
+| `--question` | Yes | Specific question about the document content (string) |
+
+## Local File Support
+
+Parameters that accept URLs (`<url>`) also accept local file paths. The CLI automatically uploads local files before sending to the API.
+
+## See Also
+
+- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags

package/skills/gsk-understand-images/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: gsk-understand-images
+version: 1.0.0
+description: Analyze and understand images. Supports multiple images and custom analysis
+  instructions.
+metadata:
+  category: general
+  requires:
+    bins:
+    - gsk
+  cliHelp: gsk analyze --help
+---
+
+# gsk-understand-images
+
+**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
+
+Analyze and understand images. Supports multiple images and custom analysis instructions.
+
+## Usage
+
+```bash
+gsk analyze [options]
+```
+
+**Aliases:** `understand_images`, `analyze`
+
+## Flags
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `-i`, `--image_urls` | Yes |  (array) |
+| `-r`, `--instruction` | Yes | Detailed instructions for image analysis, specifying: 1) What aspects of the images to analyze (e.g., objects, text, style, context), 2) How to analyze them (e.g., focus on specific details, compare elements), 3) What specific information to extract (e.g., key objects, text content, visual elements), and 4) Any particular context or perspective to consider during analysis. (string) |
+
+## Local File Support
+
+Parameters that accept URLs (`--image_urls`) also accept local file paths. The CLI automatically uploads local files before sending to the API.
+
+## See Also
+
+- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags

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

@@ -0,0 +1,53 @@
+---
+name: gsk-video-generation
+version: 1.0.0
+description: Generate videos using AI models. Supports text-to-video and image-to-video
+  generation.
+metadata:
+  category: general
+  requires:
+    bins:
+    - gsk
+  cliHelp: gsk video --help
+---
+
+# gsk-video-generation
+
+**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
+
+Generate videos using AI models. Supports text-to-video and image-to-video generation.
+
+## Usage
+
+```bash
+gsk video [options]
+```
+
+**Aliases:** `video_generation`, `video`
+
+## Flags
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `<query>` (positional) | Yes | Detailed description of the video to generate. duration is recommended to be 5 ~ 10 seconds. For image-to-image transitions (user provides start and end frames) e.g., 'A timelapse of a flower blooming in a garden'. (string) |
+| `--file_name` | No | The name of the video to generate.  (string, null) |
+| `-m`, `--model` | Yes | The model to use for video generation. kling/v3: Latest Kling V3 with audio. Pro/Standard quality modes. Supported ratios: 16:9, 9:16, 1:1. Duration: 3-15s. gemini/veo3.1: Gemini Veo 3.1 - Latest version with enhanced quality and features. Supports text-to-video and image-to-video generation with improved quality. Duration: 8s. Supported ratios: 16:9, 9:16. Supports fast_mode (faster generation) and hd_mode (1080p quality). gemini/veo3.1/reference-to-video: Gemini Veo 3.1 Reference-to-Video mode. Generate video using multiple reference images to guide the generation. Requires 1+ reference images. Duration: 8s. Supported ratios: 16:9, 9:16. Supports fast_mode and hd_mode options. gemini/veo3.1/first-last-frame-to-video: Veo 3.1 First-Last Frame mode. Generate video by specifying first and last frames for precise transitions. Requires exactly 2 images. Duration: 8s. Supported ratios: 16:9, 9:16. Supports fast_mode and hd_mode options.minimax/hailuo-2.3/standard: MiniMax Hailuo-2.3 Standard model for high-quality video generation. Supports both text-to-video and image-to-video generation with improved quality. Supports first & last frame control for precise video transitions. Fast generation (about 4min one video), cost-effective option. Supported ratios: 16:9, 9:16. Duration: 6s, 10swan/v2.6: Latest Wan model with 1080p support and audio integration. Supports text-to-video, image-to-video, and reference-to-video. Supported ratios: 16:9, 9:16, 1:1, 4:3, 3:4. Duration: 5s, 10s, 15svidu/q3: Vidu Q3 model with enhanced quality and audio generation. Supports both text-to-video and image-to-video generation. Supported ratios: 16:9, 9:16, 4:3, 3:4, 1:1. Duration: 1-16s. Resolution: 720p, 1080prunway/gen4_turbo: A model for generate video with high quality, fast.Supported ratios: 5:3, 3:5. Only support i2v. Duration: 5s, 10sofficial/pixverse/v5: A model for generate video with high quality, fast.fast(30s one video) but expensive. Supported ratios: 16:9, 9:16, 4:3, 1:1, 3:4. Duration: 5s, 8sAdditional features: 1. Generating smooth video transitions between two specified keyframes (start and end frames). fal-ai/bytedance/seedance/v1.5/pro: Bytedance Seedance v1.5 Pro model for high-quality video generation. Latest enhanced version supporting both text-to-video and image-to-video with audio generation. Supports first & last frame control for precise video transitions. HD output (720p), improved visual quality with native audio support. Supported ratios: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16. Duration: 4-12ssora-2: OpenAI Sora 2 video generation model for fast, creative videos. Supports text-to-video, image-to-video (reference frame), and video remixing. Designed for speed and experimentation. Supported ratios: 16:9, 9:16. Duration: 4s, 8s, 12ssora-2-pro: OpenAI Sora 2 Pro for production-quality videos. Higher fidelity than sora-2, best for cinematic footage and marketing assets. Supports 720p and 1080p resolutions. Supported ratios: 16:9, 9:16. Duration: 4s, 8sfal-ai/bytedance-upscaler/upscale/video: ByteDance Video Upscaler for enhancing video quality. Upscales videos to higher resolutions (2k) Requires video_url parameter. Does NOT generate new videos. Use when user wants to improve quality of existing videos.xai/grok-imagine-video: xAI Grok Imagine Video model for high-quality video generation. Supports both text-to-video and image-to-video generation. 720p HD output. Flexible duration 1-15 seconds. Supported ratios: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, 9:21. Duration: 1-15s (string, one of: kling/v3, gemini/veo3.1, gemini/veo3.1/reference-to-video, gemini/veo3.1/first-last-frame-to-video, minimax/hailuo-2.3/standard, wan/v2.6, vidu/q3, runway/gen4_turbo, official/pixverse/v5, fal-ai/bytedance/seedance/v1.5/pro, sora-2, sora-2-pro, fal-ai/bytedance-upscaler/upscale/video, xai/grok-imagine-video) |
+| `-i`, `--image_urls` | No | The URLs of the images to use as reference key frames for the video generation. For single image models, provide 1 image. For multi-image models (like kling/v1.6/pro/elements), provide 1-4 images in sequence order. For start-end models (like vidu, pixverse), provide exactly 2 images (start and end frames). (default is [], if the task is based on one or more reference images, it is required) (array) |
+| `-r`, `--aspect_ratio` | No | The aspect ratio of the video to generate. For image-to-video (i2v) generation, this should match the aspect ratio of your input image(s). (string, one of: 16:9, 9:16, 4:3, 1:1, 9:21) |
+| `-d`, `--duration` | No | The duration of the video to generate in seconds. (number, default: `5`) |
+| `-a`, `--audio_url` | No | Audio URL for audio integration in video generation. - Optional for Wan v2.5 model (custom audio: music or speech, WAV/MP3, 3-10s, up to 15MB) - Required for OmniHuman model (audio-driven animation) Leave empty if no audio is needed. (string, default: ``) |
+| `--video_urls` | No | Input video URLs for video processing tasks. For Wan v2.6 reference-to-video: provide 1-3 reference videos (use @Video1, @Video2, @Video3 in prompt to reference them). (array, default: `[]`) |
+| `--fast_mode` | No | Enable fast mode for quicker generation at lower cost. Only applicable to Veo 3.1 models. Default: false. (boolean, default: `False`) |
+| `--hd_mode` | No | Enable HD (1080p) mode for higher quality output. Only applicable to Veo 3.1 models. Higher cost (2x). Default: false. (boolean, default: `False`) |
+
+## Local File Support
+
+Parameters that accept URLs (`--image_urls`, `--audio_url`, `--video_urls`) also accept local file paths. The CLI automatically uploads local files before sending to the API.
+
+## Output File
+
+Use `-o <path>` / `--output-file <path>` to download the generated result directly to a local file.
+
+## See Also
+
+- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags

package/skills/gsk-vm-email-send/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: gsk-vm-email-send
+version: 1.0.0
+description: Send an email from your OpenClaw VM's email address. Recipient must be
+  in the VM's email allowlist or be your own login email.
+metadata:
+  category: vm_email
+  requires:
+    bins:
+    - gsk
+  cliHelp: gsk vm_email send --help
+---
+
+# gsk-vm-email-send
+
+**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
+
+Send an email from your OpenClaw VM's email address. Recipient must be in the VM's email allowlist or be your own login email.
+
+## Usage
+
+```bash
+gsk vm_email send [options]
+```
+
+## Flags
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `<to_email>` (positional) | Yes | Recipient email address (string) |
+| `-s`, `--subject` | Yes | Email subject line (string) |
+| `-b`, `--body` | Yes | Email body (plain text or markdown) (string) |
+| `-f`, `--from_vm` | No | Sender VM email address or VM name. Defaults to the first running VM's email. (string) |
+
+> **CAUTION:** This command performs a write/send operation. Double-check parameters before executing.
+
+## See Also
+
+- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags

package/skills/gsk-web-search/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: gsk-web-search
+version: 1.0.0
+description: Search the web. Returns search results with titles, snippets, and URLs.
+metadata:
+  category: general
+  requires:
+    bins:
+    - gsk
+  cliHelp: gsk search --help
+---
+
+# gsk-web-search
+
+**PREREQUISITE:** Read `../gsk-shared/SKILL.md` for auth, global flags, and security rules.
+
+Search the web. Returns search results with titles, snippets, and URLs.
+
+## Usage
+
+```bash
+gsk search [options]
+```
+
+**Aliases:** `web_search`, `search`
+
+## Flags
+
+| Flag | Required | Description |
+|------|----------|-------------|
+| `<q>` (positional) | Yes | User's search query (string) |
+
+## See Also
+
+- [gsk-shared](../gsk-shared/SKILL.md) — Authentication and global flags