agentsclimarketplace
Sign in

Example web search

Skill Phoenixrr2113/agent-harness/defaults/skills/example-web-search

Example HTTP tool definition for a fictional web search API. Copy and adapt for real services.From its SKILL.md

Install
npx -y skills add Phoenixrr2113/agent-harness --skill example-web-search

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

3 things to look at

  • reads credentialsReads from 1 credential source: `WEB_SEARCH_API_KEY`.
  • 1 stars1 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.
  • fetches URLsInstructs the agent to fetch 1 URL, including https://api.example.com/v1/search.

SKILL.md

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

Tool: Example Web Search (template)

This is a template tool definition. Its status is example, so validators and loaders will recognize it as non-executable scaffolding. Copy this file to tools/<your-tool>.md, change the status to active, and point it at a real service.

Authentication

Set the API key in your environment:

export WEB_SEARCH_API_KEY="your-key-here"

The tool reads WEB_SEARCH_API_KEY at call time. Never hardcode keys in this file.

Operations

search

Method: GET URL: https://api.example.com/v1/search Headers: Authorization: Bearer $WEB_SEARCH_API_KEY

Query parameters:

  • q (string, required) — search query
  • limit (integer, optional, default 10) — max results, 1-50
  • lang (string, optional, default "en") — ISO 639-1 code

Response: JSON with results: [{title, url, snippet}]

Example call

curl -H "Authorization: Bearer $WEB_SEARCH_API_KEY" \
  "https://api.example.com/v1/search?q=climate+change&limit=5"

Notes

  • Rate limit: 100 requests / minute (fictional).
  • This endpoint does not exist. Swap it for a real provider (Brave, Tavily, Serper, etc.) before marking the tool active.

Related: [research]

Available scripts

  • scripts/call.sh — Auto-generated from this tool's Operations section. Review before relying on it.

What ships with it: 2 files

3.8 KB alongside SKILL.md, 1 of them executable

evals/

scripts/

Keep looking

Skills are one crate of 325,949. 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.