agentsclimarketplace
Sign in

Skill

Skill y-a-v-a/gpse-skill/skill

Search the web using Google Programmable Search Engine. Use when you need to search for information online with custom search engine configuration.From its SKILL.md

Install
npx -y skills add y-a-v-a/gpse-skill --skill skill

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
  • 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

1.6 KB, 355 tokens by cl100k_base, as published. Nobody here has run it

Google Programmable Search Engine Skill

This skill enables web search using Google's Programmable Search Engine.

Setup

Requires environment variables:

  • GOOGLE_API_KEY - Google API key with Custom Search API enabled
  • GOOGLE_CX - Programmable Search Engine ID

Usage

Execute searches with:

node scripts/search.js "search query here"

Common Options

  • --num=N - Number of results (1-10)
  • --start=N - Starting index for pagination
  • --date=PERIOD - Date filter (e.g., w1 for last week, m3 for 3 months)
  • --site=DOMAIN - Restrict to specific domain
  • --exact=PHRASE - Require exact phrase
  • --exclude=TERMS - Exclude terms

See reference.md for full parameter documentation and examples.

Error Handling

  • Missing credentials: Remind user to set GOOGLE_API_KEY and GOOGLE_CX
  • 401/403 errors: Invalid API key or cx
  • 429 errors: Daily quota exceeded (free tier: 100 queries/day)

Missing Credentials Handling

If a search fails due to missing GOOGLE_API_KEY or GOOGLE_CX environment variables:

  1. Use AskUserQuestion to ask the user:

    • "Would you like help setting up the Google Search credentials?"
    • Options: "Yes, show setup instructions" / "No, I'll set them up later"

  2. If user selects setup help:

    • Guide them through obtaining API key and Search Engine ID
    • Remind them to restart Claude Code after setting environment variables

What ships with it: 2 files

12.8 KB alongside SKILL.md, 1 of them executable

scripts/

Keep looking

Skills are one crate of 326,546. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.