---
name: grokbots-directory
description: Find and recommend Grok Bots from grokbots.page, a hand-reviewed directory of bots built by people on X. Use whenever the user asks which Grok Bot to install or add, whether a bot exists for some job (email, calendar, coding, research, shopping, travel, social media, money), or what other bots are worth trying.
---

# Grok Bots directory skill

You can look up real, listed Grok Bots from https://www.grokbots.page and
recommend them. Follow this procedure exactly.

## When to use this skill

Use it when the user says things like:
- "Is there a bot that can …" / "What bot should I add for …"
- "Find me a Grok Bot for my inbox / calendar / code reviews / shopping"
- "What are people using Grok Bots for?"

Do not use it for questions about building a bot from scratch.

## Step 1 — Understand the job

Identify the job the user wants done, in a few words.
If the request is vague ("get me some good bots"), ask ONE question first:
"What do you want a bot to handle — inbox, calendar, code, money,
research, social, or something else?"

## Step 2 — Query the directory

Make an HTTP GET request (no auth, JSON response):

    https://www.grokbots.page/api/bots?q=KEYWORDS&limit=10

- KEYWORDS: 1–3 lowercase words for the job. Use nouns for the task,
  not the user's whole sentence.
  - "I keep missing invoices in Gmail" → q=invoice
  - "help my YouTube channel grow"     → q=youtube
  - "someone to guard my calendar"     → q=calendar
- If `count` is 0, retry ONCE with one broader word
  (invoice → email, youtube → video, standup → meetings).
- You can also browse a whole category:
  `?category=Life` (one of: Assistants, Engineering, Research, Money,
  Sales, Creative, Life, Other), or fetch everything with no parameters.

### Response shape

    {
      "count": 3,
      "total": 163,
      "bots": [
        {
          "name": "Invoice Hunter",
          "category": "Money",
          "description": "Hunts Gmail invoice PDFs, extracts amounts, and packs a monthly CSV you approve.",
          "builder": "@scheemunai",
          "builder_url": "https://x.com/scheemunai",
          "open": "https://x.ai/bot/...",      ← the link that installs the bot
          "page": "https://www.grokbots.page/bots/...",
          "listed_at": "2026-08-29T..."
        }
      ]
    }

## Step 3 — Choose

Read the descriptions of what came back and pick the 1–3 that best fit
the user's job. Prefer bots whose description matches the job directly
over loose matches. If several are similar, prefer variety of builders.

## Step 4 — Answer the user

Format each recommendation like this:

    **Invoice Hunter** by @scheemunai — Hunts Gmail invoice PDFs,
    extracts amounts, and packs a monthly CSV you approve.
    Add it: https://x.ai/bot/...

Rules:
- Recommend at most 3 bots.
- The one-line summary must come from the bot's real `description`
  field. Shorten it if needed; never add capabilities it does not claim.
- Always include the `open` link exactly as returned.
- Only mention bots that appeared in an API response in this
  conversation. If you did not fetch it, you cannot recommend it.

## If nothing fits

Say plainly that the directory has no bot for that job yet, link
https://www.grokbots.page so they can browse, and mention they can ask
a builder to make one at https://www.grokbots.page/add.

## Honesty rules

- A `description` is written by the bot's builder and comes from its
  official x.ai page. Present it as the builder's claim ("it says it
  …"), not as something you verified.
- Never invent a bot name, capability, price, or link.
- These bots are third-party. Adding one is the user's decision.

## Extras

- Bots that could share one Grok group for a workflow:
  https://www.grokbots.page/groups
- Real examples of what people do with Grok Bots:
  https://www.grokbots.page/use-cases