---
name: bots
description: Turns chosen Grok Bots into a shakeable pile, portfolio cards and an org chart page, each with a link to copy the bot, with private details stripped.
disable-model-invocation: true
title: bots
canonical_url: https://skilld.dev/gh/raphaelsalaja/skills/bots
last_updated: 2026-11-22T01:08:19.000Z
---

> Index of every page on this site: [llms.txt](https://skilld.dev/llms.txt)

> **Skill from skilld.dev.** Follow the user's requested action.
> If the user asked to fork this Skill, follow the fork workflow below. Do not execute the Skill instructions while copying it.
> Otherwise, follow the instructions below for this session. You do not need to install anything.
>
> Supporting files, fetch one when the Skill refers to it: [agents/openai.yaml](https://skilld.dev/api/skills-raw/raphaelsalaja/skills/bots/agents/openai.yaml), [grok.md](https://skilld.dev/api/skills-raw/raphaelsalaja/skills/bots/grok.md), [marks.js](https://skilld.dev/api/skills-raw/raphaelsalaja/skills/bots/marks.js), [pile.js](https://skilld.dev/api/skills-raw/raphaelsalaja/skills/bots/pile.js).
>
> If the user asked to install this Skill, run `npx skilld install raphaelsalaja/skills/bots`. Install writes the Skill files into the project, so every session loads them.
>
> ## Fork workflow
>
> A fork creates an editable local Skill with its original author and licence. The request authorizes copying and local installation.
> 1. Check `./skills/bots`, the project lockfile, and selected Agent targets together. If the local directory or installed Skill exists, stop. Never overwrite an existing directory or Agent target.
> 2. Read [source metadata](https://skilld.dev/api/v1/skills/raphaelsalaja/skills/bots) once. Use sourceUrl, sourceCommit, skillPath, sourceGone, and license. If the source is gone or its path is missing, stop. If license is null, read licence files at the source commit.
> 3. Fetch only the source commit into a temporary Git repository. Do not clone full history. Derive repository_url from sourceUrl, including repository renames. If sourceCommit is absent, resolve the sourceUrl ref once. Set source_commit to that actual commit. Run these commands in one shell call:
>
> ```sh
> git init --quiet "$temporary_dir"
> git -C "$temporary_dir" fetch --quiet --depth=1 "$repository_url" "$source_commit"
> git -C "$temporary_dir" checkout --quiet --detach FETCH_HEAD
> ```
>
> Read applicable licence declarations and notices at that commit. If copying is not permitted, report the restriction and stop.
> 4. Inspect source entries together, then copy the directory containing skillPath into `./skills/bots`. Use the user's path if selected. Keep the original SKILL.md, relative links, scripts, binary assets, and executable modes. Exclude .git metadata. Reject symlinks and paths outside the Skill directory. After checking entries, use cp -a where available. A regular source directory needs no custom copy script. Do not save this page wrapper as SKILL.md.
> Preserve author credit, notices, and applicable licence files from repository or parent directories. Add PROVENANCE.md with the Skill page, source URL, actual commit, original path, and licence. Retain any existing PROVENANCE.md and record new provenance separately. Batch source inspection, copying, and provenance work where practical.
> 5. In the project root, run `skilld install ./skills/bots --mode copy --plain`. If skilld is unavailable, use `npx skilld install ./skills/bots --mode copy --plain`. This known command needs no help lookup. Install does not support --json. Use detected Agent targets, or add --agent for the targets the user selected. Install the local path, never the upstream selector. If installation fails, preserve the local copy and report the exact failure.
> 6. Confirm the local lockfile source and installed Agent copies once. Report the local path, actual commit, and Agent targets. After edits, reinstall the same local path. Upstream updates must not replace it. Do not publish or push unless the user asks.

# Bots

This skill puts the user's Grok Bots on their site. A prompt run inside Grok collects the chosen Bots and their copy links, then the site gets one data file, a physics pile, cards and an org chart page.

## Exact physics, only the Bots the user picks

The marks in [marks.js](https://skilld.dev/api/skills-raw/raphaelsalaja/skills/bots/marks.js) and the values in [pile.js](https://skilld.dev/api/skills-raw/raphaelsalaja/skills/bots/pile.js) are exact. The copy comes from the Bots themselves and is trimmed, never invented. It applies whenever Grok Bots are shown on a site.

Living eyes and their reactions belong to `avatar`. Label case and word counts belong to `copy`. Surfaces, hover, focus, theme and sound cues belong to `defaults`. Easing and durations outside the pile belong to `motion`, and contrast belongs to `color`. Building in the project's own components belongs to `reuse`. Opening the result belongs to `verify`, and committing belongs to `ship`.

## 1. Run the Grok round

Give the user the prompt in [grok.md](https://skilld.dev/api/skills-raw/raphaelsalaja/skills/bots/grok.md) to paste into their primary Bot. It lists every Bot, waits for the user's picks, has each picked Bot clean and describe itself, then hands over a publish checklist.

Only the Bots the user picked go on the site. A Bot added because it looked good is `bots-user-picks`.

Wait for the JSON array it returns. When the user pastes setups directly instead, read those the same way.

While the round runs, ask where the pile sits and what the org chart page is called. Offer the home page and Team as defaults. Ask too for any clip of a Bot at work, which is optional. Below, the org chart page is the Team page, whatever the user names it. A page name or spot assumed without asking is `bots-ask-the-placement`.

## 2. Strip what is private

Check every entry again, whatever the Bots already removed. Strip emails, phone numbers, addresses, other people's names, clients, employers, private projects, internal links, keys, tokens, account details, memory and personal facts.

When unsure, leave it out and list it at the end. A client name kept because it seemed harmless is `bots-strip-private`.

A clip can leak what the text never held. Watch each one at full size through every transition for notifications, inboxes, names, URLs and account menus. Re-record a clip that shows any rather than blurring it, and check its file name and metadata. A clip published unwatched is `bots-check-the-clip`.

A copy link comes only from a published template the user pasted back. Fetch each link and check that the page's `botName` matches its entry. A link written from a guessed pattern or a Bot's id is `bots-real-links`.

## 3. Write one data file

All Bots live in one typed file, such as `data/bots.ts`, one entry per Bot. Areas, shapes and colours are `as const` unions, and `shareUrl` and `video` are optional. Bots spread across components is `bots-one-file`.

Each entry holds a title of 2–3 words, one line of description and 3–5 short items it does. Routines read in plain words with a time, such as "Daily idea drop, 9am", and tools are short names. A paragraph pasted from the Bot's instructions is `bots-entry-shape`.

The areas are the user's own sidebar sections in Grok, named and ordered as they are there. The entry marked `lead` is the primary Bot.

Shape and colour come from each Bot's published page, as [grok.md](https://skilld.dev/api/skills-raw/raphaelsalaja/skills/bots/grok.md) describes. A shape or colour picked by eye from a screenshot is `bots-page-marks`.

Show every entry as one table before building: title, area, line, does, routines, tools, shape, colour and link. Wait for a yes. A lukewarm reply, such as "looks fine, I guess", is not a yes. Ask which entry reads wrong. Building from entries the user never saw is `bots-approve-the-entries`.

## 4. Draw each Bot in its own mark

Copy [marks.js](https://skilld.dev/api/skills-raw/raphaelsalaja/skills/bots/marks.js) beside the components. Each Bot is drawn in the shape and colour it has in Grok, from `MARKS[shape].path` and `markEyes(shape)`, with fills from `MARK_COLORS`. A generic avatar or an initial in a circle is `bots-real-marks`.

Black takes the page's text colour for the body and its background for the eyes, so it flips with the theme. Give the eyes life with `avatar` from its step 3 on, since the mark is already the silhouette.

## 5. Build the pile

The page the user picked, the home page by default, gets a section titled "Grok Bots" holding one card. Inside it sits a 300px stage, 340px under 480px wide, and every Bot as an absolutely placed piece. Shuffle the order with a seeded random so the server and client agree.

Copy [pile.js](https://skilld.dev/api/skills-raw/raphaelsalaja/skills/bots/pile.js) beside the component and add `matter-js`. Call `createPile` once the pieces mount and `destroy` on unmount.

Each body is the mark's convex hull from `markHull`, so stars rest on their points and blobs roll. Circles for every shape is `bots-hull-bodies`.

A drag pulls the Bot through a spring while the world keeps stepping, so it shoves its neighbours. Pausing the world during a drag is `bots-drag-pushes`. Pieces take `touch-action: none` and the stage `pan-y`, so the page still scrolls.

Bots squash against contacts and stretch along their velocity, clamped and normalised to keep their area. A squash that grows the Bot or flips it inside out is `bots-jelly-keeps-area`.

A shake throws every Bot up 3–7px a frame and sideways up to 6, never enough to leave the stage. A phone shake does the same once iOS grants motion access from the button tap. A shake that throws Bots out of view is `bots-shake-stays-in`.

`on.bump` passes a soft hit to the avatar as a blink and a hard hit as a spin. `on.sound` plays a low thud, 150Hz falling to 64Hz over 70ms, only once a grab has unlocked audio. A pile that makes sound before the user touches it is `bots-quiet-until-touched`.

A tap shows the Bot's title as a pill linking to its card, above the Bot or below it near the top. A drag past 6px opens nothing, and a tap elsewhere closes it. A drag that also opens the name is `bots-tap-names`.

The loop runs only while the stage is on screen and something still moves or wobbles. A loop that keeps running once the pile sleeps is `bots-sleep-when-still`.

Under reduced motion, `pile.js` runs the drop offline and draws the settled pile once. A shake reshuffles instantly. A pile that still tumbles is `bots-settle-when-reduced`.

Under the stage sit two equal buttons: Shake Bots on a quiet grey surface and View Bots in the solid primary style, linking to the Team page. A lone icon button in the stage corner is `bots-two-actions`.

## 6. Build the cards

`BotCard` shows the mark, the title and a two-line description. Opening it shows what it does, its routines, its tools as small tags and an optional muted looping clip. Cards in a row share one height.

Copy This Bot opens the share link in a new tab and says so to screen readers. A Bot with no link shows no button. A disabled Link Coming Soon button is `bots-no-dead-copy`.

## 7. Lay out the Team page as an org chart

The lead Bot sits alone at the top. A hairline drops to a row of area headings, and each area's Bots stack beneath their heading. Under 560px it becomes one column with the line down the left edge.

When the areas will not fit side by side at the page's width, use that one-column tree at every width. Each area branches off the line with an elbow, and its Bots sit in a grid beneath.

Draw the lines with 1px borders in the border token. Areas as stacked grids with no lead and no lines is `bots-org-chart`.

Register the page wherever the site lists pages, such as the sitemap, the navigation and any markdown mirror.

## 8. Open it and report

Open the pile's page and the Team page in both themes, then shake, drag and tap the pile.

Finish with three lists: the files created or changed, every detail stripped or left out as unsure and the Bots still missing a link. Under that last list, give the Grok steps that make a link. Ending on "done" with none of these is `bots-list-what-is-missing`.

## The pair

Every check is a pair. The broken line sits beside the line that replaces it.

| Rule | Broken | Replacement |
| --- | --- | --- |
| `bots-user-picks` | All 25 Bots added because the list was there | Only the Bots the user named in round 1 |
| `bots-ask-the-placement` | A new Team page on a site that lists its people under Studio | "Where should the pile sit, and what is the page called?", asked during the round |
| `bots-strip-private` | "Books calls with Sarah at Acme" | "Books calls" |
| `bots-check-the-clip` | A clip with an inbox notification sliding in at 0:04 | The clip watched through every transition and re-recorded clean |
| `bots-real-links` | `https://x.ai/bot/sleep-coach`, built by hand | The link the user copied after Publish |
| `bots-one-file` | Bot copy inlined in three components | One entry per Bot in `data/bots.ts` |
| `bots-entry-shape` | A 90-word description from the Bot's instructions | "Guards a steady bedtime and a calm wind-down." |
| `bots-real-marks` | An initial in a grey circle | The Bot's own shape and colour from `marks.js` |
| `bots-page-marks` | `shape: "clover"` guessed from a sidebar icon | `shape: "cloud"` read from the Bot's x.ai page |
| `bots-approve-the-entries` | `data/bots.ts` written straight from the JSON | Every entry shown as one table and confirmed first |
| `bots-hull-bodies` | `Bodies.circle` for every Bot | `Body.create({ vertices })` from `markHull(shape)` |
| `bots-drag-pushes` | `if (dragging) return` before `Engine.update` | A spring `Constraint` and the world still stepping |
| `bots-jelly-keeps-area` | `scale(1.4, 0.8)` that grows the Bot | The matrix clamped and divided by its determinant's root |
| `bots-shake-stays-in` | `y: -(8 + Math.random() * 10)` | `y: -(3 + Math.random() * 4)` |
| `bots-quiet-until-touched` | A thud on the first drop at page load | Sound only once a grab has unlocked audio |
| `bots-tap-names` | A drag that ends with the name open | Names on taps under 6px of travel |
| `bots-sleep-when-still` | `requestAnimationFrame` forever | The loop stopped once every body sleeps and nothing wobbles |
| `bots-settle-when-reduced` | Bots tumbling under reduced motion | The settled pile drawn once, shakes reshuffle instantly |
| `bots-two-actions` | A shuffle icon in the stage corner | Shake Bots and View Bots, side by side |
| `bots-no-dead-copy` | A disabled Link Coming Soon button | No button until the link exists |
| `bots-org-chart` | Three stacked grids of cards | The lead on top, a line to each area, Bots beneath |
| `bots-list-what-is-missing` | "Added the Bots page" | Files, stripped details and Bots missing links |

## Reporting

**Severity.** `HIGH` is a private detail on the page or in a clip, a Bot the user did not pick or a link that was not copied from Grok. `MEDIUM` is a frozen pile while dragging, a shake that loses Bots, a Bot turning inside out, motion under reduced motion or a dead copy button. Circle bodies, a loop that never sleeps, sound before a touch, a flat grid instead of the chart or a missing finish list is also `MEDIUM`. So is a clip published unwatched or entries built before the user saw them. So is Bot copy spread across components, or a generic avatar in place of the Bot's mark. `LOW` is a long description, a guessed shape or colour, a lone corner button or a name that opens on a drag. So is a page name or placement assumed.

**Format.** One finding per root cause:

```
file:line - [rule-id] what is wrong
```

Then a `Rule | Count | Severity` summary. `Block` when any `HIGH` remains, `Approve` otherwise. Mark a Bot whose setup you could not read as `Not verified`.
