grok-bot-templates

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

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

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

Tap a team. Try Eng (Bug Reproduction + Issue Drafter + PR Reviewer).
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.

Bot	Why	Raw PROFILE
PR Reviewer	Review starts at the scary diff	PROFILE.md
Bug Reproduction	Staging repro packs — never production data	PROFILE.md
Chief of Staff	Only items that map to the priority list	PROFILE.md
Inbox Triage	Buckets and drafts — never send	PROFILE.md
Research Desk	Claims, evidence, disagreements, not-found	PROFILE.md

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

Persona	Start
I have Grok Bot open	Paste START.md
I want a team	Tap Eng / Ops / Sales in Setup · teams/
I want to write a Bot	`npx --yes github:cobusgreyling/grok-bot-templates new my-job --category ops` · authoring
I want to convert one	convert/
I want to share one	sanitizer · sharing
My Bot should read this catalog	docs/agent.md

Autonomy

Level	Name	Week one
L0	Observe	Read, report
L1	Draft	Default. Review-ready artifacts
L2	Approved action	Named writes after in-chat approval
L3	Scheduled	Routine + missing-source policy + test run

→ 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

Command	Purpose
`start`	Print START.md
`list`	Catalog
`show <id>`	One contract
`init <id> --print`	Paste-ready PROFILE
`init --team <id>`	Roster + kickoff
`score [--badge]`	Bot Ready, optional SVG / shields.md
`validate` / `doctor`	Schema, secrets, drift
`catalog`	JSON for other Bots
`new`	Scaffold a stub

Progressive adoption

Level	What you get	Docs
1 — One Bot	PROFILE + first task	anatomy
2 — Skill	Six official fields	SPEC
3 — Team	2–4 Bots, visible handoffs	chat docs
4 — Routine	After two good runs + test run	skills & routines

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.

URL	Contents
https://cobusgreyling.github.io/grok-bot-templates/api/v1/status.json	version, capabilities
https://cobusgreyling.github.io/grok-bot-templates/catalog.json	full catalog
https://cobusgreyling.github.io/grok-bot-templates/api/v1/teams.json	teams
https://cobusgreyling.github.io/grok-bot-templates/llms.txt	short machine summary

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

Specs

README