Grok
TEAM: one command installs the seven workers' files; you open each session yourself and carry the handoffs between them. Researcher goes first.
Set up Bots through the account controls using the complete roles and manual relay below. See compatibility for setup evidence and host trials.
- SOLO: paste the starter in zero-install, or give a file-capable session the complete canonical skill.
- TEAM: install or attach all five bundles, open the seven sessions yourself, then paste the setup request below in each session.
- Native skill (Grok Build CLI): install with
--target grok, which writes.grok/skills/website-build-skill/, then trust the project folder (accept the trust prompt, or rungrok --trustthere once). Grok Build offers project skills only in a trusted folder. Native loading was tested on Grok Build CLI 1.0.40 (macOS, SOLO, trusted folder, 2026-09-24; one run, limitations in the receipt);grok inspect --jsonlists the skill with sourceprojectwhen it is available to you. Grok Bot is a separate app with its own setup, below. Current status: compatibility. - Independence: workers from one model family leave the independent release gate BLOCKED.
- Reference: Bot setup, collaboration, skills. Use these references when checking the installed controls.
Give me the team (option 2). I open each session myself and carry the handoffs between them, with Researcher first. Use the attached team.md and the complete role body for this session. Return its setup acknowledgement with session reference, model family and tool limits. I collect seven acknowledgements through the manual setup below. Give my request to Researcher first; every other worker waits for the saved-library gate. Use a reviewer from a different model family for independent review.
Grok Bot
Grok Bot is the Bots app (desktop, iPhone and Android). It keeps skills in its own private skill library, so --target grok does not reach it. This setup follows xAI's Grok Bot documentation, read 2026-09-25; no trial receipt exists yet, so treat each step as the documented route and confirm it on your account.
What the app gives you
- One private skill library shared by all your Bots. Type
/in the composer to use a saved skill; if one is missing, open Marketplace → Your plugins → Manage plugins and skills and look under Private skills. - One shared cloud computer for all your Bots, with a browser, a command line and a
/workspacefolder every Bot can read. Keepsite-work/there. - Bots with their own conversation and memory. A Bot's standing rules live in its profile description.
- Group chats of two to six Bots,
@mentions, and direct Bot-to-Bot handoffs. Handoffs posted to a group are text only, so a Bot sends an image directly to the Bot that must inspect it. - Up to six attachments per message, 25 MB per document.
- Every Bot runs on Grok: there is no model picker (reported by the operator, 2026-09-25). A reviewer from a different model family therefore sits outside Grok Bot.
SOLO
- Choose New (
Cmd/Ctrl+N), then Create new Bot, and use Edit Profile to name itWebsite Builder. - Ask it to install the package into
/workspaceand learn it as a skill:Run npx website-build-skill@latest --solo --target portable --dir /workspace/website-build-skill --yes, read /workspace/website-build-skill/.website-build-skill/SKILL.md, and save it as a private skill called website-build-skill that reads the files beside it.The Bot learns the skill and keeps it across conversations (reported by the operator, 2026-09-25). - Type
/and confirmwebsite-build-skillis listed. If it is missing, attach the five bundles to your first message and ask the Bot to keep them in/workspace/website-build-skill/. - Start the build with
/website-build-skilland your site request.
TEAM
- Create six Bots in the order below (Researcher, Coordinator, Designer, Graphics, Builder, Optimizer). Save each role body from the team bundle to
/workspace/site-work/roles/<role>.mdand write in each description:You are Website <Role>. Before every task, read /workspace/site-work/roles/<role>.md and follow it. - Put those six in one group, Researcher first. A Bot keeps its memory, skills and context when it joins a group (reported by the operator, 2026-09-25). Six is the group limit, and it fits: the seventh role, Reviewer, needs a different model family, so it runs outside Grok Bot and you relay the final packet to it.
- Follow the steps below for setup acknowledgements, the research gate and the handoff contract. Since every Bot reads
/workspace, pass file paths in handoffs rather than reattaching files.
Manual fallback
TEAM: one command installs the seven workers' files; you open each session yourself and carry the handoffs between them. Researcher goes first. This manual relay is the TEAM workflow.
Prepare the files and workspace
- Get the complete
docs/bundles/team.md,method.md,prompts.md,playbooks.md, andchecklists.mdfrom the same release. The team bundle contains the seven complete role bodies and this guide; the prompts bundle contains active prompts. - Get
skills/website-build-skill/archive/graphics-design-original.mdseparately for Researcher's provenance reading. Keep its inactive header and do not execute its historical save instructions. - Choose the private project workspace where
site-work/will live. Keep its research and brand files out of the public skill repository and deployment output. - Open your host's Bots or agents area and create one worker at a time. Give each the entire named role body wherever your host keeps standing instructions (in Grok Bot, a role file in
/workspacethat the description points to, as in Grok Bot), then save. If your host has no such place, use separate chats and relay the complete role packets manually rather than inventing an API. - Give each Bot the method, prompt, playbook and checklist bundles as files or pasted text through controls your account actually provides. If a filename inside an instruction is inaccessible, attach or paste that file's contents with its label before work starts. Confirm file access separately for each Bot.
- Request only a setup acknowledgement: name, received role, route, actual model family if known, tools, and inaccessible files. For all Bots except Researcher add:
Wait for the research gate; do not begin your role yet.Pass each work gate using its own required evidence.
Create these seven Bots in this exact order
- Website Researcher. Click New, name it
Website Researcher, paste the fullroles/researcher.mdbody from the team bundle, and save. Supply the active website research prompt and inactive graphics original. Check search, URL/repository reads, viewing, and project file persistence. This Bot gets the first work assignment. - Website Coordinator. Click New, name it
Website Coordinator, paste the fullroles/coordinator.mdbody, and save. Give it the other six Bot names and actual routes, the handoff contract below, and the instruction to wait for Researcher's passing receipt. - Website Designer. Click New, name it
Website Designer, pasteroles/designer.mdin full, and save. Check whether it can receive/view images and produce visual mockups. It waits for research acceptance and the scope-to-designer handoff. - Website Graphics. Click New, name it
Website Graphics, pasteroles/graphics.mdin full, and save. Record available image/export tools and existing authorized tiers. It waits for research acceptance, then works with Designer on assets and rights. - Website Builder. Click New, name it
Website Builder, pasteroles/builder.mdin full, and save. Check code/file/browser tools and authorized implementation access. It waits for accepted research and the user's named mockup selection before choosing a stack or coding. - Website Optimizer. Click New, name it
Website Optimizer, pasteroles/optimizer.mdin full, and save. Check source retrieval, validators and rendered-page access. It works with and after Builder on its bounded discovery assignment. - Website Reviewer. Click New, name it
Website Reviewer, pasteroles/reviewer.mdin full, and save. Use read-only permissions where the host supports them; otherwise use a read-only artifact packet and returned text. Record the actual model family. If the host cannot supply a family different from Builder's, keep this Bot INTERNAL and relay the final packet to an actual different-family reviewer. The release gate stays BLOCKED until that review happens.
Connect the group and verify its routes
- If your host offers group chats, create
Website Designand add the saved workers in the same order, Researcher first, up to the host's group limit (six in Grok Bot, where Reviewer runs outside the group). Record the actual route for each. Verify one bounded setup message reaches the intended recipient using the host's documented addressing controls. - Use separate Bot chats and relay each handoff and its attachments manually, including when the account offers a group view. Keep distinct workers on separate routes; separate workers need separate routes, and labels inside one chat stay one worker. Ordinary single-chat work uses SOLO.
- If group messages are text-only, attach mockups and assets directly to the receiving Bot. Image review needs the Bot to open the image itself; a text path alone gives it only the path, so confirm the receiving Bot can inspect the image directly.
- Give Coordinator this complete contract after replacing each angle-bracket route with the real saved Bot/chat reference. Unresolved placeholders keep setup incomplete.
You are Website Coordinator for Website Design. Website Researcher is agent one
and owns the shared research library. Do not begin work until its passing research
receipt arrives. Your first job then is to read its files and validate that gate.
Routes:
Website Researcher: <actual Researcher route>
Website Designer: <actual Designer route>
Website Graphics: <actual Graphics route>
Website Builder: <actual Builder route>
Website Optimizer: <actual Optimizer route>
Website Reviewer: <actual Reviewer route>
Your Coordinator route: <actual Coordinator route>
Project workspace: <chosen private project workspace>
Record actual routes, families, tools, and ownership after research acceptance.
Do not infer family or permissions from a Bot name. Keep one writer per artifact.
Researcher alone writes site-work/research/library/. Every other role reads its
named library files first, learns the domain checklists, and tops up its own domain.
Send stale or wrong claims back to Researcher; pause affected work for correction.
The research gate requires saved files for all touched domains and an opened source
URL, publication/update date or explicit unknown, and access date on or after the ASK DATE for every claim we will act on. UNVERIFIED placeholders cannot pass.
Then confirm my brief and send scope-to-designer and scope-to-graphics. Require my
named mockup selection before selected-design-to-builder. Send scope-to-optimizer
with Builder's route/content inputs. Send the fixed final candidate to Reviewer
only after pre-review gates pass. Different-family review remains mandatory.
Read every returned artifact. Preserve Reviewer returns unchanged. Use every field
in templates/handoff.yaml and record gate acceptance only in site-work/status.md.
Return every complete addressed packet for me to relay manually.
Trigger the first work handoff
Send this directly to Website Researcher:
Begin user-request-to-researcher. You are the first working agent.
My site request: <paste the actual audience, main action, pages, and known constraints>
My authorized project workspace: <chosen workspace>
Supplied materials: <attach any existing brief, brand materials, or source links>
Use your full role and prompts/01-website-deep-research.md to cover all fourteen
research domains current as of the ASK DATE. Ask for only missing inputs needed to research.
Write the grouped library, README headlines, per-domain checklists, source/date and
disagreement ledgers, surprises, memory proposal/receipt, and staleness schedule.
If you cannot search, say so, provide query-plan.md and unresolved-claims.md, and
leave the research gate BLOCKED. If you cannot save files, return named file bodies
for me to save and reattach; wait for read-back before passing the disk gate.
Pass only when the saved library covers every touched domain and every claim we
will act on has an opened source URL, a publication/update date or explicit unknown, and an access date on or after the ASK DATE. Read back the actual saved files before confirming persistence.
Then return research-to-coordinator addressed to <actual Coordinator route> for me
to relay, using all handoff fields and readable artifacts. No other role starts before this research gate.
- First receipt: Researcher supplies
site-work/handoffs/researcher/research-<revision>.yamland its library. Copy the whole receipt and attach the library to Coordinator yourself. - First acceptance: Coordinator opens the files, checks coverage and source dates, and writes PASS or BLOCKED in
site-work/status.md. Only PASS releases downstream scope handoffs. - First design: Designer and Graphics read their named library files, return learning/top-up receipts, and apply their domain checklists. They open the evidence behind the research summary before starting.
- Persistence: preserve the files and receipts, and reattach the current revision in each new session. Carry state in the saved files, since a Bot may not remember a group chat. A durable-memory proposal remains pending until an actual supported save is read back.
- Completion: report seven saved definitions, seven setup acknowledgements, actual routes and families, research-gate status, and all remaining capability limits separately. Never call the whole team ready from definition creation alone.