Templates for Grok Bot

Browse the template catalog →
Pick a card. Copy PROFILE. Paste it into Edit Profile. No clone, no Node.

Stop pasting vibes. Design the Bot. Get a score.

Operating contracts for Grok Bot — xAI's durable AI teammate. Spec, Bot Ready score, teams, skills, routines. Paste one URL. Tap a team.

Companion in spirit to loop-engineering (inner loops) and outerloop (evidence → verdict). This catalog is the job → boundary → skill → routine → team kit for Grok Bot.

Not affiliated with xAI. Grok Bot is a product of xAI / Cursor. Templates here are contracts you paste into your account.

Install in 60 seconds — no Node

1. In Grok Bot: New → Create new agent. Name it Setup.
2. Paste this URL and send:

https://raw.githubusercontent.com/cobusgreyling/grok-bot-templates/main/START.md

3. Tap a team. Try Eng (Bug Reproduction + Issue Drafter + PR Reviewer).
4. Connect the plugins it lists. Stay at L1 for a week — drafts, not sends.

Setup fetches each Bot's PROFILE.md. It does not invent prompts.

→ Pages catalog (copy PROFILE per card) · Quickstart · What do you want to do?

Or copy one PROFILE

Paste the raw PROFILE.md into Bot actions → Edit Profile. Connect the plugins it names. Send the first task. Do not enable a routine until two runs look right.

Full catalog: 49 templates · 10 teams · 47 skills · 8 routines. All stable templates score 100/100 Bot Ready.

CLI (optional)

npx --yes github:cobusgreyling/grok-bot-templates list
npx --yes github:cobusgreyling/grok-bot-templates init pr-reviewer --print
npx --yes github:cobusgreyling/grok-bot-templates score pr-reviewer --badge
npx --yes github:cobusgreyling/grok-bot-templates init --team eng --out ./eng-bots

npx @cobusgreyling/grokbot is the scoped name; it publishes on the next npm release. GitHub npx works today.

Choose a door

Autonomy

→ docs/autonomy.md

Bot Ready score

grokbot score <id> is 100 points: job, sources, never-list, deliverable, first task, skill, no-data, autonomy, example, routine discipline, share-safe, working style.

Ready means ≥ 80. CI fails a stable template under that line.

npx --yes github:cobusgreyling/grok-bot-templates score --badge --md
# ![bot ready 100/100](https://img.shields.io/badge/bot%20ready-100%2F100-2e7d32)

The loop in 60 seconds

Job → Boundary → Skill → Routine → Team
who   never      how     when      handoff

A Bot is a durable teammate with a name, a job, a conversation, and working context. Official docs: Get started · Bots · Use cases.

Week one is L1 Draft — review-ready artifacts, no send/post/pay/merge/production. Same discipline as loop-engineering's report-only week.

→ SPEC.md (binding) · vs alternatives

CLI essentials

Progressive adoption

Safety

Shared computer. Shared plugins. Share links are public. This catalog is share-safe by construction and scanned in CI.

→ docs/safety.md · SECURITY.md

Machine API

Public, no auth. Point a Bot at docs/agent.md.

Status

v1.1.0 — installer-first distribution: START.md as the hero path, Pages copy buttons, catalog API, Bot Ready badge.

→ CHANGELOG.md · ROADMAP.md · Discussions

Development

git clone https://github.com/cobusgreyling/grok-bot-templates.git
cd grok-bot-templates
npm install
npm run ci

→ CONTRIBUTING.md · Good first issues · Code of Conduct

Sources

• Grok Bot docs
• Official use cases
• Research notes
• loop-engineering (quality bar)

License

MIT © 2026 Cobus Greyling