Grok Bot Architecture skill
Nine role skills plus human approval: a chief of staff and specialists hand work off through typed records.
- 63 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- Roles and checks consist of texts and format validation scripts; by themselves they gain no rights over external systems.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/grok-bot-architectureDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- Roles and checks consist of texts and format validation scripts; by themselves they gain no rights over external systems.
This is third-party code. Review the repository files before installing.
What it does
A reference architecture for an AI agent team with nine role skills: chief of staff, engineering, product, inbox, finance, career, publishing, security and hobby. Each role has its own job, context, deliverable and boundary. Roles describe responsibility while the platform enforces permissions. A handoff between roles needs an owner, goal, completion condition and references, and a privileged action waits for a human decision bound to the action and revision. The repository has Node.js validation scripts for handoff and interrupt records, a Markdown board checker and a sample approval runtime. A Cursor plugin loads the skills.
Who it is for. Engineers and operators building a persistent team of AI teammates without handing them unchecked authority.
Good fit when
- A chief of staff is needed to distribute tasks between narrow specialists.
- Work handoff between agents must follow a record with an owner and a completion condition.
- A publication or payment must wait for a human confirmation bound to the specific action.
- Scheduled routines with a budget and a stop on failure are planned.
Not a fit when
- A ready orchestration engine is needed: the repository gives a reference and checks, not a working platform.
- A replacement for the Grok Bot product is expected: the project is independent and holds no source of that product.
- Permissions must be enforced by the skill itself: the host performs permission checks.
Example request
Use the chief-of-staff role: split this goal into tasks for the engineering and security roles and prepare handoff records.Limitations
The project is independent and not affiliated with xAI or Cursor. Roles describe responsibility while the host enforces permissions, so without platform setup the boundary rules remain text. The validation scripts check file shape and do not authenticate the human approver or execute side effects. Node.js is needed to run the checks, with no external packages or keys. Grok Bot setup is described in 10 steps in `grok-bot/SETUP.md`, and approval rules map to personal auto review rules. The license is MIT.
How to disable. Remove the Cursor plugin or the skill folders from your agent skills directory. The cloned repository is deleted separately.
FAQ
Which roles are in the set?
Nine: chief of staff, engineering, product, inbox, finance, career, publishing, security and hobby. Each sits in `skills/<role>/SKILL.md`.
How do I verify the repository?
With `bash scripts/check.sh` after cloning. It checks JSON records, the Markdown board, plugin packaging, doc coherence, links and the approval runtime. No packages or keys are needed.
How do I verify a handoff record?
With `node scripts/validate-handoff.mjs /path/to/handoff.json`; for an interrupt record use `validate-interrupt.mjs`.
Is this the Grok Bot product?
No. It is an independent reference, holds no product source code and is not affiliated with xAI.
Do I have to connect the skills to Cursor?
The install guide covers the Cursor plugin and manual paste into any host.
Discussion
No questions or reviews yet.
Related
SkillsGrok Build is xAI's terminal coding agent. It reads Claude Code skills, plugins and MCP servers with zero setup.
A skill with 25 commands to audit and improve the prompts, tools and agent designs of a project in Cursor, Claude Code and Codex
A template catalog for Grok Bot: 49 profiles, teams, skills and routines, plus a CLI with a 100-point readiness score.
One agent launches others in the background: Claude Code, Codex, Copilot CLI, Grok Build and Pi, with a model chosen per stage.
A base AGENTS.md and 12 skills: delegation to Codex, Grok, Devin and Antigravity, planning, copywriting, scoped changes.
Skills and the porch CLI for agent orchestration: a strong model plans, cheaper ones code, several model families review.
README in short
The README has a quick path for Grok Bot, a neutral way to run the checks and a list of cases where the architecture is unnecessary. Examples live in the `examples` directory.