How do I install the Omriariav Workspace CLI Search skill?

Run npx get-skill add tomevault-io/omriariav-workspace-cli-search in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Omriariav Workspace CLI Search skill do?

Google Search (gws search) It is listed under Coding & Dev Tools on SkillMD.

Is Omriariav Workspace CLI Search safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Omriariav Workspace CLI Search?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Omriariav Workspace CLI Search free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Omriariav Workspace CLI Search?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Omriariav Workspace CLI Search by tomevault-io

Name: Omriariav Workspace CLI Search
Author: tomevault-io

File contents

Google Search (gws search)

gws search provides CLI access to Google Programmable Search Engine (Custom Search) with structured JSON output.

Disclaimer: gws is not the official Google CLI. This is an independent, open-source project not endorsed by or affiliated with Google.

Dependency Check

Before executing any gws command, verify the CLI is installed:

gws version

If not found, install: go install github.com/omriariav/workspace-cli/cmd/gws@latest

Authentication

Requires separate API credentials beyond standard OAuth:

Create a Programmable Search Engine at https://programmablesearchengine.google.com/
Get an API key from Google Cloud Console
Set GWS_SEARCH_ENGINE_ID and GWS_SEARCH_API_KEY environment variables, or add search_engine_id and search_api_key to your config file

Quick Command Reference

Task	Command
Web search	`gws search "query"`
Limit results	`gws search "query" --max 5`
Search a site	`gws search "query" --site example.com`
Image search	`gws search "query" --type image`
Paginate results	`gws search "query" --start 11`
Override API key	`gws search "query" --api-key <key> --engine-id <id>`

Detailed Usage

search — Web search

gws search <query> [flags]

Flags:

--max int — Maximum number of results, 1-10 (default 10)
--site string — Restrict search to a specific site
--type string — Search type: image or empty for web
--start int — Start index for results pagination (default 1)
--api-key string — API Key (overrides config)
--engine-id string — Search Engine ID (overrides config)

Examples:

gws search "golang best practices"
gws search "kubernetes deployment" --max 5
gws search "release notes" --site github.com
gws search "logo" --type image
gws search "query" --start 11    # Page 2 of results

Output Modes

gws search "query" --format json    # Structured JSON (default)
gws search "query" --format yaml    # YAML format
gws search "query" --format text    # Human-readable text

Tips for AI Agents

Always use --format json (the default) for programmatic parsing
This command uses Google's Custom Search API, not standard Google search — it requires a separate API key and search engine ID
Max 10 results per request; use --start to paginate
The --site flag is useful for searching within a specific domain
Image search (--type image) returns image URLs and metadata

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: omriariav-workspace-cli-searchdescription: Google Search (gws search)---# Google Search (gws search)`gws search` provides CLI access to Google Programmable Search Engine (Custom Search) with structured JSON output.> **Disclaimer:** `gws` is not the official Google CLI. This is an independent, open-source project not endorsed by or affiliated with Google.## Dependency Check**Before executing any `gws` command**, verify the CLI is installed:```bashgws version```If not found, install: `go install github.com/omriariav/workspace-cli/cmd/gws@latest`## AuthenticationRequires separate API credentials beyond standard OAuth:1. Create a Programmable Search Engine at https://programmablesearchengine.google.com/2. Get an API key from Google Cloud Console3. Set `GWS_SEARCH_ENGINE_ID` and `GWS_SEARCH_API_KEY` environment variables, or add `search_engine_id` and `search_api_key` to your config file## Quick Command Reference| Task | Command ||------|---------|| Web search | `gws search "query"` || Limit results | `gws search "query" --max 5` || Search a site | `gws search "query" --site example.com` || Image search | `gws search "query" --type image` || Paginate results | `gws search "query" --start 11` || Override API key | `gws search "query" --api-key <key> --engine-id <id>` |## Detailed Usage### search — Web search```bashgws search <query> [flags]```**Flags:**- `--max int` — Maximum number of results, 1-10 (default 10)- `--site string` — Restrict search to a specific site- `--type string` — Search type: `image` or empty for web- `--start int` — Start index for results pagination (default 1)- `--api-key string` — API Key (overrides config)- `--engine-id string` — Search Engine ID (overrides config)**Examples:**```bashgws search "golang best practices"gws search "kubernetes deployment" --max 5gws search "release notes" --site github.comgws search "logo" --type imagegws search "query" --start 11 # Page 2 of results```## Output Modes```bashgws search "query" --format json # Structured JSON (default)gws search "query" --format yaml # YAML formatgws search "query" --format text # Human-readable text```## Tips for AI Agents- Always use `--format json` (the default) for programmatic parsing- This command uses Google's Custom Search API, not standard Google search — it requires a separate API key and search engine ID- Max 10 results per request; use `--start` to paginate- The `--site` flag is useful for searching within a specific domain- Image search (`--type image`) returns image URLs and metadata---> Converted and distributed by [TomeVault](https://tomevault.io/claim/omriariav) — claim your Tome and manage your conversions.

Frequently asked questions

Omriariav Workspace CLI Search