simulator-chat

simulator-chat is a skill for Claude Code from corezoid/simulator-ai-plugin. It costs 253 tokens per session (2,728 once invoked), scanned A, original, MIT.

A chat and messaging guide for Simulator.Company, where one-to-one and group chats are event records and messages are comments attached to them.

In plain words
What is it for?
Sending messages, creating or reusing private and group chats, managing participants, and reading conversation comments.
Why use it?
It handles finding or creating the correct conversation and adding the right participants when the platform has no separate chat or send-message action.

Skill for Claude Code

Written for Claude Code: $CLAUDE_PLUGIN_ROOT variable.

Runs only inside its plugin — its command needs a path that Claude Code sets for a plugin’s own hooks and for nothing else. Install the plugin, not this.

Part of the simulator plugin — 21 skills, 1 MCP server shipped together

Good fit Sending messages, creating or reusing private and group chats, managing participants, and reading conversation comments.

Compare 6 skills from other repositories ↓
Install

Getting it into your agent

This one installs as part of its plugin. Adding the marketplace and installing the plugin brings it with everything else the plugin ships.

Claude Code
/plugin marketplace add corezoid/simulator-ai-plugin
Claude Code
/plugin install simulator

Made for: Claude Code.

Or install simulator, the plugin that ships this one along with the rest of its 21 skills, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for simulator-chat

README.md
[![agentmods](https://agentmods.dev/badge/skills/corezoid/simulator-ai-plugin/simulator-chat/github.svg)](https://agentmods.dev/skills/corezoid/simulator-ai-plugin/simulator-chat)
Your own site
<a href="https://agentmods.dev/skills/corezoid/simulator-ai-plugin/simulator-chat"><img src="https://agentmods.dev/badge/skills/corezoid/simulator-ai-plugin/simulator-chat/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for simulator-chat

Your own site · 80×15
<a href="https://agentmods.dev/skills/corezoid/simulator-ai-plugin/simulator-chat"><img src="https://agentmods.dev/badge/skills/corezoid/simulator-ai-plugin/simulator-chat.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 253 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,728 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00253 $0.02728
Opus 5.5 $0.00101 $0.01091
Sonnet 5.5 $0.00051 $0.00546
Haiku 4.5 $0.00025 $0.00273

Measured 1mo ago against content hash faa21f32a189, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

simulator-chat scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/simulator/skills/simulator-chat/SKILL.md · 211 lines

How it starts

The opening of the file, as written. The whole thing — 211 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Curated tool names (v2 server): searchUsers, getUsers, getSystemActor, getForms, filterActors, createActor, getActorByRef, saveAccessRules, createReaction, getReactions. Call them by these exact names. There is no dedicated "create chat" / "send message" tool — a chat is composed from these.

Simulator.Company Chat Specialist

In Simulator.Company a chat is an actor of the Events system form:

  • data.chatType = "p2p" → a 1:1 chat · "group" → a group chat · empty → a plain event / SIP meeting (not a chat).
  • Participants = the chat actor's access-rule members (keyed by userId) — not a data field. The creator is the implicit owner; other participants are added with saveAccessRules.
  • Messages = comment reactions posted under the chat actor.

There is no server-side "p2p has exactly two members / don't duplicate" enforcement — this skill owns that discipline, and it must match the platform's standard p2p convention or two clients will create duplicate chats for the same pair. The convention:

  • Deterministic ref = p2pConversation_<minUserId>_<maxUserId> — both participants' raw workspace userIds sorted ascending, joined with _. This is the p2p dedup key; the UI finds/reuses a chat only by this ref.
  • title = <nickA>:p2p:<nickB> — nicks ordered by the same ascending userId sort.
  • data = { chatType:"p2p", startDate:<nowSec>, endDate:<nowSec>, scheduleMeeting:false }.
  • Participants are added by a separate saveAccessRules call (never inline in the create body); the creator is owner implicitly.

Read $CLAUDE_PLUGIN_ROOT/docs/entities/chats.md for the full model, the verbatim Events-form field list, and the current-user constraint.

Reply to the user in their own language.


Test case: "write a message to user N"

This is the canonical flow. Each step names the exact tool.

1 — Resolve user N

searchUsers(query="N")          # accId defaults to the active workspace

Read the full file on GitHub · 211 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 211 lines · 253 tokens per session scan A faa21f32a189

Subscribe to this mod's changes

simulator-chat is a skill published in the GitHub repository corezoid/simulator-ai-plugin (60 stars, last pushed yesterday), licensed MIT. It adds 253 tokens to every session and 2,728 once invoked, about $0.0010 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.