Checking in

Checking in takes a room into your Dot or your Grok Bot. There are four formats. Pick the one that fits where you'll use it.

A roomits live version
Pasteone block of text
Grok Bota Bot description
SkillSKILL.md
Pluginzip bundle
Any Dotpaste it in as its task
Grok BotEdit Profile → description
Codex or Grok.agents/skills or .grok/skills
ChatGPT desktop~/.codex/plugins
Each format comes from the room's live version. Check-ins are counted on the room.
PasteGrok BotSkillPlugin
Works withAny DotAny Grok BotCodex, GrokChatGPT desktop app, Grok
Install neededNoNoSave one fileUnzip and register
Includes rules and guardrailsYesYes, as approval rulesYesYes
Connects apps for youNoNoNoChatGPT only, for supported apps
Share with a teamSend the textSend the text, or share the Bot as a templateCommit it to a repoAdmins can publish it to the workspace

Every format includes the room's number, version, author and a link back to the room, so you can always tell where a setup came from.

Paste into your Dot

The simplest option. It always works, with nothing to install.

  1. Connect the room's apps in ChatGPT under Settings → Plugins.
  2. On the room's page, click Check in → Copy setup.
  3. Open your Dot at chatgpt.com/dots and paste it in as its task.
  4. Add each rule in Settings → Personalization → Custom rules. See how the rules map.

What you copy looks like this:

Text
Sunday Inbox Digest
(Dot Hotel room 102 · v1 · by @front-desk · https://dothotel.app/rooms/sunday-digest)

Every Sunday at 6pm, review email I received in the past 7 days. …

Custom Rules for this job:
Allow:
- Read email from the past 7 days
- Send one weekly digest email to me only
Block:
- Archive, label, move, or delete any email
- Email anyone other than me

Never:
- Read-only on your inbox: no archiving, labeling, or deleting
- Never emails anyone but you

Apps this uses: Gmail. If one isn't connected, stop and ask me to connect it.

From the terminal: npx dothotel paste 102.

Grok Bot

The same setup, written as a Grok Bot description. Grok keeps standing rules in a Bot's description and task-specific asks in the conversation, so the rules go in Grok's own terms:

Room ruleIn Grok Bot
AllowAllow automatically
Require approvalAsk first
BlockNever
  1. Connect the room's apps in Grok under Settings → Plugins.
  2. In Grok Bot, create a Bot (New → Create new agent) and open Bot actions → Edit Profile.
  3. On the room's page, click Check in → Grok Bot → Copy setup, and paste it in as the Bot's description.
  4. Add the Ask first rules to your approval rules too, so they always stop for you. Ask first wins when rules conflict, and a room's rules only ever make a Bot stricter.

What you copy looks like this:

Text
Sunday Inbox Digest
(Dot Hotel room 102 · v1 · by @front-desk · https://dothotel.app/rooms/sunday-digest)

Every Sunday at 6pm, review email I received in the past 7 days. …

Approval rules for this job (they add to my own rules and never loosen them; Ask first wins when rules conflict):
Allow automatically:
- Read email from the past 7 days
- Send one weekly digest email to me only
Never:
- Archive, label, move, or delete any email
- Email anyone other than me

Guardrails:
- Read-only on your inbox: no archiving, labeling, or deleting
- Never emails anyone but you

Apps this uses: Gmail. Connect them under Settings → Plugins. If one isn't available, stop and ask me to connect it instead of working around it.

These rules stay true for every task. …

When I message you without a task, run the "Sunday Inbox Digest" setup.

From the terminal: npx dothotel paste 102 --grok.

Skill

A SKILL.md file in the Agent Skills format. Codex and Grok both read it.

.agents/skills/
  dot-hotel-sunday-digest/
    SKILL.md  # instructions, Custom Rules, access list, guardrails
    agents/openai.yaml  # display name and default prompt
  1. Save it as ~/.agents/skills/dot-hotel-sunday-digest/SKILL.md to use it everywhere, or under .agents/skills/ in a repo to share it with your team.
  2. Codex picks it up automatically. Restart Codex if it doesn't show, then type @ to use it.

In Grok: save it as ~/.grok/skills/dot-hotel-sunday-digest/SKILL.md (or .grok/skills/ in a repo) for Grok Build, or upload it to Grok Bot under Marketplace → Your plugins → Manage plugins and skills. Type / to use it.

From the terminal: npx dothotel add sunday-digest (current project) or npx dothotel add sunday-digest -g (everywhere). Add --grok to install into Grok's folders instead.

Plugin bundle

A zip in OpenAI's plugin format, with a Grok manifest alongside: the skill plus the app connections it needs.

~/.codex/plugins/
  dot-hotel-sunday-digest/
    .codex-plugin/plugin.json  # name, version, author, description
    .grok-plugin/plugin.json  # the same, for Grok
    .app.json  # the apps to connect
    skills/dot-hotel-sunday-digest/
      SKILL.md
      agents/openai.yaml
    README.md
  1. Unzip it into ~/.codex/plugins/.
  2. List it in your personal marketplace file, ~/.agents/plugins/marketplace.json. OpenAI's guide shows the format.
  3. Restart the ChatGPT desktop app and install it from Plugins. Workspace admins can then Publish it to their team.

From the terminal: npx dothotel add sunday-digest --plugin.

In Grok: unzip it into ~/.grok/plugins/ instead and restart Grok (or npx dothotel add sunday-digest --plugin --grok). Grok has no connector ids to bundle, so connect the room's apps yourself under Settings → Plugins.

Staying up to date

Rooms get new versions when their authors improve them. Your copy doesn't change by itself:

  • Paste or Grok Bot: copy the setup again from the room's page.
  • Skill or plugin installed with the CLI: run npx dothotel update. It fetches only rooms with a newer version.
  • Downloaded by hand: download it again.