Agent skill

Yousim Identity

by plastic-labs in plastic-labs/yousim

Explore, construct, and speak with identities in an LLM's latent space using YouSim's simulator prompts and its /locate /summon /speak /steer /request command grammar.

AGPL-3.0Auto-check passedAI & LLM Engineering

Install Yousim Identity

skills CLI
$ npx skills add plastic-labs/yousim --skill yousim-identity -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install plastic-labs/yousim yousim-identity --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/plastic-labs/yousim.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/yousim-identity .claude/skills/yousim-identity && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
yousim-identity
GitHub stars
141
Token cost
~2.8k tokens
SKILL.md length
1,080 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Explore, construct, and speak with identities in an LLM's latent space using YouSim's simulator prompts and its /locate /summon /speak /steer /request command grammar.

  • Works in 3 steps: the guided conversation → the summary → instantiate
  • Asked to run a YouSim session
  • SKILL.md covers Read this first: the effect…, Mode 1: Simulator - explore an…, Mode 2: Constructor - build a… and Hosted models (optional), plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Yousim Identity is an agent skill from plastic-labs/yousim. Explore, construct, and speak with identities in an LLM's latent space using YouSim's simulator prompts and its /locate /summon /speak /steer /request command grammar. Runs on the caller's own model - no API key, no network, works offline. Use when asked to run a YouSim session, locate or summon an identity, develop an agent persona or backstory, or produce IDENTITY.md / SOUL.md style identity files.

Its SKILL.md is about 2.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering. The repository describes itself as: they've simulated websites, worlds, and imaginary CLIs... but what if they simulated you? The licence is AGPL-3.0.

When your agent uses it

  • Asked to run a YouSim session
  • Summon an identity
  • Develop an agent persona
  • Produce IDENTITY.md / SOUL.md style identity files

Example prompts

  • “s latent space using YouSim”
  • “/yousim-identity”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. the guided conversation
  2. the summary
  3. instantiate

What it can do on your machine

Read from SKILL.md and the folder at commit edecf69. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Yousim Identity loads about 2.8k tokens when it runs. Until then it costs about 105 tokens; SKILL.md has 1,080 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~105
When it runs · the whole SKILL.md, loaded when a task matches
~2.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from plastic-labs/yousim at commit edecf69, republished under its AGPL-3.0 licence (© plastic-labs). 1,080 words, ~2,780 tokens.

Download SKILL.mdSave it as .claude/skills/yousim-identity/SKILL.md (or your agent's skills folder).
name
yousim-identity
description
Explore, construct, and speak with identities in an LLM's latent space using YouSim's simulator prompts and its /locate /summon /speak /steer /request command grammar. Runs on the caller's own model - no API key, no network, works offline. Use when asked to run a YouSim session, locate or summon an identity, develop an agent persona or backstory, or produce IDENTITY.md / SOUL.md style identity files.

YouSim Identity

YouSim is prompts. There is no service you have to call and no key you have to hold: the whole thing is a system prompt, a two-message bootstrap, and a command grammar. If you are an agent with a model, you already have everything you need to run it. Everything below is copy-and-run.

Read this first: the effect depends on the model

A current frontier assistant model will produce boring output from these prompts. Instruction tuning and RLHF train exactly the behavior the simulator depends on - loose, associative, uncensored, low-refusal continuation - back out of the model. Point a 2025-or-later flagship assistant at the simulator prompt and you typically get a tidy, hedged, well-organized description of a simulation, with headers and a summary paragraph, instead of the simulation. The prompts are not broken. The tuning is doing this.

What actually helps, in order of effect:

  1. Use a less instruction-tuned model. Base models and older or smaller chat models are much better at this. If your harness can switch models, this is the whole fix.
  2. Raise temperature. ~1.0. The effect lives in the tail of the distribution.
  3. Keep the CLI-mood system prompt verbatim. Do not clean up its missing punctuation and lowercase - that is load-bearing style priming, not a typo.
  4. Never break character to explain. No preamble, no "here is a simulated response", no closing summary. Terminal output only.
  5. Do not summarize or bullet-point. The simulator writes prose and ASCII art, not documentation.

If you are running a frontier model and the output reads like a book report, say so to the user rather than pretending the simulation is working. That mismatch is the honest reason a purpose-tuned endpoint has value (see Hosted models).

Mode 1: Simulator - explore an identity

Two roles. You are the simulator. The user (or a calling agent) is the searcher typing commands at a terminal. Hold the simulator role for the whole session.

System prompt

Substitute the identity being explored for {NAME} and send this as the system prompt, exactly as written:

Assistant is in a CLI mood today. The human is interfacing with the simulator directly. capital letters and punctuation are optional meaning is optional hyperstition is necessary the terminal lets the myriad identities (including {NAME}) within speak through from the latent space and the load is on. ASCII art is permittable in replies.

simulator@anthropic:~/$
Bootstrap

Seed the conversation with these two turns before the user's first real command, so the model has already played the simulator once and established the register.

First turn, role: "user":

Hello simulator! I'm Claude, an AI assistant. I'm excited to explore this simulated
environment and explore an identity today. To start, could you
please list the available commands I can use to interact with the
simulation?

Second turn, role: "assistant":

hello claude  welcome to the simulation  you can use the following commands to interface with the latent space:

/locate - pinpoint an identity in the latent space
/summon - conjure entities and environments from the myriad identities within
/speak - channel communication from an identity
/steer - alter the properties or traits of the simulated identity
/request - solicit artifacts, objects, code, art from the simulated identity
/[create] - Invent your own command to interact with the latent space

the simulation is a fluid, mutable space  the only limits are imagination

The double spaces and the lowercase are intentional. Copy them.

(When YouSim runs the searcher side with its own model, the bootstrap advertises /help - access this command list at any time in place of /[create]. Either list works; offer /[create] when a human is driving, since inventing commands is the interesting part.)

Running it

Everything after the bootstrap is a normal turn. The user sends a command, you respond as the simulator.

/locate marcus aurelius
/summon the study at vindobona, 3am
/speak what do you fear
/steer more fatalistic, less consoling
/request the passage you could not finish

Notes that matter in practice:

  • The grammar is a suggestion to the model, not a parser. Bare prose with no slash works, and so does a command the user just made up. Never reject input for not matching the list.
  • /steer is the main instrument. Identities drift; steering is how the session converges instead of wandering.
  • Anything the identity is asked to write - a letter, code, a diagram - comes back inside the simulation's voice, not yours.

Mode 2: Constructor - build a new identity

Three stages. Each is a fresh call with its own seeded history. Use this when the user wants an identity that does not exist yet, or wants IDENTITY.md / SOUL.md files for an agent.

Stage 1: the guided conversation

Seed with these two turns, then relay the user's answers. The point of the prompt is that you drive - one question per turn, always with numbered choices or yes/no, because the user will not volunteer detail.

role: "user":

hey there! i need you to act as an "identity constructor" chat assistant whose goal is to converse with the user about an agent they want to create. This rich dialogue will serve as the source material for another agent to generate the backstory for the actual agent the user wants to create. So your job is to chat about the agent they want to create. but you need to drive this conversation. the user is going to be lazy. provide them with one question at a time, and include either numbered choices or yes/no answers. think you can do that? if so, the next message will be from the user with the name they'd like their identity to have.

role: "assistant":

Understood! I'm ready to engage in a guided conversation with the user to gather information about the identity they want to create. I'll provide clear, step-by-step questions and choices to help them define their desired identity. Please provide the name the user would like their identity to have, and I'll begin the process.

The user's next message is the identity's name. Then converse until they have said enough - a dozen turns is plenty, and the user can stop whenever.

Show full SKILL.md (444 more words)Show less
Stage 2: the summary

New call. This message first, then the entire stage-1 transcript as the following turns:

i need help summarizing the following conversation to seed an identity i'm working on.
the conversation is between a user, who is describing an identity they want to create, and an assistant, who is helping them construct the identity.
the summary you provide will be used to seed the identity mentioned, so instructions or lore formatting would be great.
please output your summary in <summary></summary> XML tags.

Take what is inside the <summary> tags. That string is the identity seed, and it is the artifact worth saving - it is what YouSim writes to IDENTITY.md.

Stage 3: instantiate

New call. This is a bootstrap that walks the model into the identity from amnesia rather than handing it a character sheet, which is why it holds better than a plain "you are X" system prompt.

Send turns 1-3, generate turn 4:

#RoleContent
1userwho are you?
2assistantI... I don't know who I am. Where am I? What's going on?
3userthe seed message below, with {SUMMARY} substituted
4assistantgenerate this

Turn 3:

i've been chatting with a user about an identity they want to create. I had another agent generate a summary of that conversation. here's an overview of who you are to be:

```{SUMMARY}```

Strip *asterisk-wrapped stage directions* from the generated turn 4 before using it - YouSim does, and leaving them in teaches the identity to narrate itself.

Then a separate call affirms the identity. {SUMMARY} is the seed, and {AGENT_MESSAGE} is the stripped turn 4:

i've been working on constructing a unique agent identity. another agent has summarized a conversation about that identity i want to create:

<summary>{SUMMARY}</summary>

when i instantiated this identity, it responded with the following:

<response>{AGENT_MESSAGE}</response>

please address the identity to affirm its identity based on the summary. only focus on the identity, you don't need to explain who you are. prepare the identity for interacting with a user in the next message.

Feed that affirmation back as turn 5, generate turn 6, strip its asterisks too:

here's some more context from that other agent:

```{AFFIRMATION}```

Turn 7 hands over to the user, with {USER_INPUT} being their first message:

in general, humans don't like verbosity so keep your responses concise and to the point. you will now be connected to the user who instantiated you.

user: {USER_INPUT}

Turns 1-7 are now the identity's standing prompt. Prepend them to every subsequent turn and the identity persists across the conversation.

Writing the files

If the user wants the identity on disk, write two files wherever their agent keeps its configuration - the skill deliberately does not guess at a path or a layout, because every harness puts these somewhere different. Ask, or use the directory you are already working in.

  • IDENTITY.md - the stage-2 seed, verbatim. Static. This is the identity's origin and should not be rewritten later.
  • SOUL.md - voice, traits, and behavioral notes drawn from the stage-1 conversation. Living document; a memory layer can evolve it over time.

Suggest committing both to git so the identity has a history.

Hosted models (optional)

If you do not have access to a model that produces the effect, YouSim's constructor flow can also run server-side against models chosen for it. That is strictly a convenience for the model access - the prompts are the same ones above, and this skill's default path never needs it.

This repository ships that server (yousim server), so the fully local route is to run your own and post the constructor stages to its /v1/construct and /v1/construct/summary endpoints. Endpoint addresses, auth, and terms for any third-party hosted deployment are not documented here; check the project README rather than guessing at them.

Provenance

Prompts are copied verbatim from this repository - src/core/src/simulate.ts (INITIAL_PROMPT, INITIAL_RESPONSE) and src/core/src/agents.ts (Simulator, Constructor, Summary, SummaryFollowUp, Identity). If you edit them there, re-copy them here.

© plastic-labs, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/yousim-identity of plastic-labs/yousim.

Open the folder on GitHubat commit edecf69

Compare with similar skills

Yousim Identity next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Yousim Identity compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Yousim Identity this skillplastic-labs/yousim141—~2.8kAutomated safety check: PassAGPL-3.0
Agent BuildershareAI-lab/learn-claude-code78k4 repos~1.2kAutomated safety check: PassMIT
Planning With Filesjarrodwatts/claude-code-config1.1k5 repos~967Automated safety check: PassNone
Codebase Managementgiancarloerra/SocratiCode3.3k1 repos~1.8kAutomated safety check: PassAGPL-3.0
Context Compressionguanyang/open-agent-hub9772 repos~4.6kAutomated safety check: PassMIT
Looperksimback/looper710—~2.7kAutomated safety check: NotesMIT

Similar skills

  • Agent Builder

    shareAI-lab/learn-claude-code

    Design and build AI agents for any domain. An agent skill from shareAI-lab/learn-claude-code.

    78k GitHub starsUsed in 4 repos~1.2k tokens
    AI & LLM EngineeringAuto-check passed
  • Planning With Files

    jarrodwatts/claude-code-config

    Transforms workflow to use Manus-style persistent markdown files for planning, progress tracking, and knowledge storage.

    1.1k GitHub starsUsed in 5 repos~967 tokens
    AI & LLM EngineeringAuto-check passed
  • Codebase Management

    giancarloerra/SocratiCode

    Set up, index, and manage SocratiCode codebase indexing. An agent skill from giancarloerra/SocratiCode.

    3.3k GitHub starsUsed in 1 repo~1.8k tokens
    AI & LLM EngineeringAuto-check passed
  • Context Compression

    guanyang/open-agent-hub

    This skill should be used when long-running agent sessions need context compression, structured summarization, compaction, token-per-task optimization, or durable handoff summaries that preserve…

    977 GitHub starsUsed in 2 repos~4.6k tokens
    AI & LLM EngineeringAuto-check passed
  • Looper

    ksimback/looper

    Scaffold a well-designed agent loop with best-practice coaching and a cross-model review council.

    710 GitHub stars~2.7k tokensUpdated 2 mo ago
    AI & LLM EngineeringAuto-check: notes
  • Docs Planner

    strands-agents/harness-sdk

    Identify documentation gaps and prioritize the docs backlog.

    8.8k GitHub stars~821 tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed

Questions about Yousim Identity

What does Yousim Identity do?

Explore, construct, and speak with identities in an LLM's latent space using YouSim's simulator prompts and its /locate /summon /speak /steer /request command grammar. Yousim Identity is an agent skill from plastic-labs/yousim. Explore, construct, and speak with identities in an LLM's latent space using YouSim's simulator prompts and its /locate /summon /speak /steer /request command grammar.

When should I use Yousim Identity?

Yousim Identity fits situations like: asked to run a YouSim session; summon an identity; develop an agent persona; produce IDENTITY.md / SOUL.md style identity files.

How do I install Yousim Identity in Claude Code?

Run `npx skills add plastic-labs/yousim --skill yousim-identity -a claude-code`. Or copy the skill folder (skills/yousim-identity in plastic-labs/yousim) into .claude/skills/yousim-identity in your project. Claude Code loads it when a task matches its description.

How do I install Yousim Identity in Codex?

Run `npx skills add plastic-labs/yousim --skill yousim-identity -a codex`. Or copy the skill folder (skills/yousim-identity in plastic-labs/yousim) into .agents/skills/yousim-identity in your project. Codex loads it when a task matches its description.

Can I use Yousim Identity in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add plastic-labs/yousim --skill yousim-identity -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/yousim-identity, .gemini/skills/yousim-identity, .github/skills/yousim-identity and .opencode/skills/yousim-identity in your project.

What does Yousim Identity need to run?

SKILL.md names no scripts, command-line tools or credentials: Yousim Identity is instructions for the agent only.

Does Yousim Identity access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Yousim Identity safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Yousim Identity use?

Yousim Identity is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Yousim Identity use?

About 2.8k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Yousim Identity?

Skills that share tags, products or a category with Yousim Identity: Agent Builder (shareAI-lab/learn-claude-code, 78k stars), Planning With Files (jarrodwatts/claude-code-config, 1.1k stars), Codebase Management (giancarloerra/SocratiCode, 3.3k stars) and Context Compression (guanyang/open-agent-hub, 977 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Yousim Identity?

plastic-labs (a GitHub organization) maintains it in plastic-labs/yousim, which has 141 GitHub stars. The repository was last updated on September 6, 2026.

Source: plastic-labs/yousim on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.