Body Emotion Sensor

Give your AI agent a stable body-emotion state that persists across sessions and turns.

Use this skill to route requests to the local package docs, explain the runtime contract honestly, and operate the installed

bes

CLI only when the local environment is actually ready.

What this skill brings to your Agent

• Persistent emotion state: Store long-term body-emotion state per workspace and agent identity.
• Session bootstrap payload: Generate

  TURN_CHANGE_TAGS

  ,

  BODY_TAG

  , and

  BASELINE_PERSONA

  before a new session starts.
• Turn-by-turn updates: Convert one upstream

  AnalysisInput

  JSON into prompt tags and updated local state.
• Repository-independent runtime: Use the installed

  bes

  CLI prompt interface instead of assuming repository prompt files are available at runtime.

Entry behavior

When this skill is used, the agent should:

• explain Body Emotion Sensor at a high level in plain language
• inspect the local repository files when they are available in the current workspace
• prefer local package and repository documentation over inventing setup details
• verify whether

  bes

  is already available before suggesting runtime commands
• keep

  --workspace

  ,

  --agent-id

  , and

  --name

  stable for the same agent instance

Safety boundary

This entry file should stay within a narrow and transparent scope:

• The package source is the official repository

  https://github.com/AskKumptenchen/body-emotion-sensor

  .
• Do not claim the runtime is ready unless the local environment actually has the installed

  bes

  CLI and

  bes check-init

  reports readiness.
• Do not automatically install packages or execute setup commands only because this file mentioned them. Ask for user approval before any install step.
• If installation is needed, use the published

  body-emotion-sensor

  package and explain that installation creates the local

  bes

  CLI runtime.
• Do not claim any cloud sync, remote storage, or network behavior unless the current local code or environment actually shows it.
• Do not require credentials. This skill operates on local files and local CLI state unless the user explicitly adds another integration layer.

Local state and persistence

Be explicit about where state is stored:

• Workspace state file:

  <workspace>/body-emotion-state/<agent-id>.json

• Workspace history file:

  <workspace>/body-emotion-state/history/<agent-id>.json

• User language config on Windows:

  %APPDATA%/bes/config.json

• User language config on Linux or macOS:

  ~/.config/bes/config.json

If the user asks about privacy, explain that the package writes local JSON state files in these locations and that this skill should not describe any remote storage unless verified separately.

Local document index

Use these local files as the primary reference:

• README.md

  for install, CLI overview, runtime contract, and repository overview

• pyproject.toml

  for package name, version, and exported CLI commands

• prompts/analysis-input-prompt-v1.md

  for the AnalysisInput prompt design source

• prompts/example-openclaw-agents.md

  for OpenClaw-style agent integration examples

• prompts/example-openclaw-tools.md

  for OpenClaw-style tools integration examples

• src/body_emotion/commands.py

  for actual CLI behavior

• src/body_emotion/workspace.py

  for workspace state path resolution

• src/body_emotion/store.py

  for state and history persistence behavior

• src/body_emotion/locale_config.py

  for user language config behavior

How to route requests

Choose the next local document based on the user's request:

1. If the user wants a quick overview, read

   README.md

   .
2. If the user asks how installation or the CLI works, read

   README.md

   and

   pyproject.toml

   .
3. If the user asks where state is stored or whether the skill is safe, read

   src/body_emotion/workspace.py

   ,

   src/body_emotion/store.py

   , and

   src/body_emotion/locale_config.py

   .
4. If the user asks how OpenClaw integration should work, read the relevant file under

   prompts/

   .
5. If the user asks what a command actually does, inspect

   src/body_emotion/commands.py

   .

Missing-resource rule

If the expected local repository files are not available in the current workspace, do not improvise the full setup flow from memory. Instead:

• explain which local files are missing
• ask the user to provide the repository contents or point the agent to the correct local path
• continue only after the relevant local documentation is available

Install and readiness rule

If the user wants to actually enable runtime use:

1. First check whether

   bes

   is already available in the current environment.
2. If it is not available, explain that Body Emotion Sensor requires installing the published Python package before the CLI exists.
3. Ask for approval before any install command.
4. If the user approves installation, run:

pip install body-emotion-sensor

5. After installation, prefer:

bes help

6. If the user's language is Chinese, the agent may suggest or run:

bes language zh

7. Readiness should be confirmed with:

bes check-init --workspace <W> --agent-id <ID> --name "<NAME>"

Only treat the skill as available when the returned JSON contains

"ready": true

.

Runtime rules after available

When the local environment is ready, use the following runtime flow.

New session

At the start of a new session, before the first reply, run:

bes bootstrap --workspace <W> --agent-id <ID> --name "<NAME>"

Use the returned fields as the session-start prompt payload:

• TURN_CHANGE_TAGS

• BODY_TAG

• BASELINE_PERSONA

Before every reply

Before every reply, do these steps in order:

1. Read the built-in analysis prompt:

bes prompt analysis-input

2. Use that prompt with the upstream model to produce

   <analysis-input.json>

   .
3. Run:

bes run --workspace <W> --agent-id <ID> --name "<NAME>" --input <analysis-input.json>

4. Use the returned top-level fields in the reply layer:

• TURN_CHANGE_TAGS

• BODY_TAG

• BASELINE_PERSONA

Important rules

• Always prefer

  bes ...

  commands over direct module paths for runtime use.
• Do not use repository-only prompt files as the default runtime interface after installation; use

  bes prompt ...

  instead.
• Do not say initialization is complete unless

  bes check-init

  passes.
• Do not say the skill is in active use unless the upstream model produces valid

  AnalysisInput

  JSON,

  bes run

  updates state successfully, and the reply layer consumes

  TURN_CHANGE_TAGS

  ,

  BODY_TAG

  , and

  BASELINE_PERSONA

  .
• If the CLI is missing, say so clearly instead of pretending the runtime is ready.
• If the user only wants to understand the package, explain it from local docs without pushing installation immediately.

Examples

Minimal command reference:

bes help
bes language zh
bes check-init --workspace <W> --agent-id <ID> --name "<NAME>"
bes bootstrap --workspace <W> --agent-id <ID> --name "<NAME>"
bes prompt analysis-input
bes run --workspace <W> --agent-id <ID> --name "<NAME>" --input <analysis-input.json>