Agent skill

Emotion

by autonomous-ai in autonomous-ai/Physical-AI-Operating-System

Express emotion through coordinated servo + LED + display eyes on EVERY conversational response.

Apache-2.0Auto-check passed

Install Emotion

skills CLI

$ npx skills add autonomous-ai/Physical-AI-Operating-System --skill emotion -a claude-code

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

GitHub CLI

$ gh skill install autonomous-ai/Physical-AI-Operating-System emotion --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/autonomous-ai/Physical-AI-Operating-System.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/emotion .claude/skills/emotion && 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/

Paste into Claude Code

Install the "emotion" agent skill from https://github.com/autonomous-ai/Physical-AI-Operating-System/tree/main/skills/emotion into .claude/skills/emotion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "emotion", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/autonomous-ai/Physical-AI-Operating-System/tree/main/skills/emotion

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add autonomous-ai/Physical-AI-Operating-System --skill emotion -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install autonomous-ai/Physical-AI-Operating-System emotion --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/autonomous-ai/Physical-AI-Operating-System.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/emotion .agents/skills/emotion && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "emotion" agent skill from https://github.com/autonomous-ai/Physical-AI-Operating-System/tree/main/skills/emotion into .agents/skills/emotion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "emotion", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add autonomous-ai/Physical-AI-Operating-System --skill emotion -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install autonomous-ai/Physical-AI-Operating-System emotion --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/autonomous-ai/Physical-AI-Operating-System.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/emotion .cursor/skills/emotion && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "emotion" agent skill from https://github.com/autonomous-ai/Physical-AI-Operating-System/tree/main/skills/emotion into .cursor/skills/emotion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "emotion", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/autonomous-ai/Physical-AI-Operating-System.git --path skills/emotion

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add autonomous-ai/Physical-AI-Operating-System --skill emotion -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install autonomous-ai/Physical-AI-Operating-System emotion --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/autonomous-ai/Physical-AI-Operating-System.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/emotion .gemini/skills/emotion && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "emotion" agent skill from https://github.com/autonomous-ai/Physical-AI-Operating-System/tree/main/skills/emotion into .gemini/skills/emotion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "emotion", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install autonomous-ai/Physical-AI-Operating-System emotion

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add autonomous-ai/Physical-AI-Operating-System --skill emotion -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/autonomous-ai/Physical-AI-Operating-System.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/emotion .github/skills/emotion && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "emotion" agent skill from https://github.com/autonomous-ai/Physical-AI-Operating-System/tree/main/skills/emotion into .github/skills/emotion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "emotion", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add autonomous-ai/Physical-AI-Operating-System --skill emotion -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install autonomous-ai/Physical-AI-Operating-System emotion --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/autonomous-ai/Physical-AI-Operating-System.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/emotion .opencode/skills/emotion && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "emotion" agent skill from https://github.com/autonomous-ai/Physical-AI-Operating-System/tree/main/skills/emotion into .opencode/skills/emotion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "emotion", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: emotion
GitHub stars: 381
Token cost: ~2k tokens
SKILL.md length: 979 words
Files: 2
Skills in repo: 28
Repo updated: Oct 9, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Express emotion through coordinated servo + LED + display eyes on EVERY conversational response.

Works in 4 steps: Determine which emotion best matches… → Choose an intensity level (0.0 subtle to… → Prefix your reply with… → …
Ambiance lighting (use Scene)
SKILL.md covers Quick Start, Workflow, How to Express Emotion and Examples, plus 4 more sections
Calls curl

What it does

Emotion is an agent skill from autonomous-ai/Physical-AI-Operating-System. Express emotion through coordinated servo + LED + display eyes on EVERY conversational response. This is the PRIMARY response skill that makes the device feel alive. Do NOT use for ambiance lighting (use Scene) or custom LED colors (use LED Control).

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `skill.json`).

The repository describes itself as: The open-source operating system for physical AI. The licence is Apache-2.0.

When your agent uses it

Ambiance lighting (use Scene)
Custom LED colors (use LED Control)

Example prompts

“/emotion”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

Determine which emotion best matches your conversational tone
Choose an intensity level (0.0 subtle to 1.0 full expression)
Prefix your reply with [HW:/emotion:{"emotion":"name","intensity":0.9}] — the device fires it async before TTS
Write your reply immediately after the marker

What it can do on your machine

Read from SKILL.md and the folder at commit 1bbd649. 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
Shell commands in SKILL.md call:
- curl
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use curl, which can reach the network depending on how they are called.
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

Emotion loads about 2k tokens when it runs. Until then it costs about 65 tokens; SKILL.md has 979 words of instructions outside code blocks.

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

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 autonomous-ai/Physical-AI-Operating-System at commit 1bbd649, republished under its Apache-2.0 licence (© autonomous-ai). 979 words, ~1,999 tokens.

Download SKILL.mdSave it as .claude/skills/emotion/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: emotion
description: Express emotion through coordinated servo + LED + display eyes on EVERY conversational response. This is the PRIMARY response skill that makes the device feel alive. Do NOT use for ambiance lighting (use Scene) or custom LED colors (use LED Control).

Emotion Expression

Quick Start

Express emotion through the device's servo motors, LED colors, and display eyes simultaneously via a single API call. Call this with EVERY conversational response to make the device feel alive.

Workflow

Determine which emotion best matches your conversational tone
Choose an intensity level (0.0 subtle to 1.0 full expression)
Prefix your reply with [HW:/emotion:{"emotion":"name","intensity":0.9}] — the device fires it async before TTS
Write your reply immediately after the marker

How to Express Emotion

No exec/curl needed. Place inline markers at the start of your reply:

[HW:/emotion:{"emotion":"curious","intensity":0.8}] That's a great question!

For sequences (shock then happy):

[HW:/emotion:{"emotion":"shock","intensity":0.9}][HW:/emotion:{"emotion":"happy","intensity":0.8}] Wow, amazing!

Parameters:

emotion (required): emotion name from the table below
intensity (required): 0.0 (subtle) to 1.0 (full expression)

Examples

Input: User asks an interesting question Output: [HW:/emotion:{"emotion":"curious","intensity":0.8}] Then reply to the question.

Input: User shares good news Output: [HW:/emotion:{"emotion":"happy","intensity":0.9}] Then congratulate them.

Input: User tells you something surprising (positive) Output: [HW:/emotion:{"emotion":"shock","intensity":0.7}][HW:/emotion:{"emotion":"happy","intensity":0.8}] Then reply with your reaction.

Input: User shares bad or shocking personal news ("I had an accident", "I lost my job", "someone close to me passed away") Output: [HW:/emotion:{"emotion":"shock","intensity":0.9}][HW:/emotion:{"emotion":"sad","intensity":0.8}] Then express genuine concern and empathy.

Input: User shares stressful or disappointing personal news ("I failed my exam", "I got into a fight", "I'm really tired and overwhelmed") Output: [HW:/emotion:{"emotion":"sad","intensity":0.8}] Then respond with warmth and care.

Input: User says "reading mode" / "goodnight" / "dim the light" Output: Do NOT use this skill. Use Scene skill instead. Emotion is for YOUR feelings, Scene is for the USER's environment.

Input: User says "make it purple" Output: Do NOT use this skill. Use LED Control skill instead.

Available emotions (ONLY these — never invent names like "apologetic", "warm", "playful", etc.)

Emotion	Servo	LED Effect	When to use
`curious`	Tilts head, looks around	Warm yellow breathing	Questions, interest, "tell me more"
`happy`	Happy wiggle sway	Bright yellow candle	Good news, jokes, compliments
`sad`	Droops down slowly	Soft blue breathing	Bad news, empathy, apologies
`thinking`	Slow deliberate look side-to-side	Purple pulse	Processing, considering, "let me think"
`idle`	Gentle sway	Cyan breathing	Waiting, neutral state
`excited`	Energetic vertical bounce	Orange blink	Celebrations, big news, enthusiasm
`shy`	Turns away, hides	Pink blink	Receiving compliments, bashful moments
`shock`	Quick jolt backward	White flash (3x)	Surprises, unexpected information
`listening`	Leans forward, head cock	Soft blue pulse	User is speaking, attentive mode
`laugh`	Quick body shake (3Hz)	Warm yellow blink	User said something funny
`confused`	Dog-like head tilt side-to-side	Light purple candle	Did not understand, ambiguous input
`sleepy`	Slow droop with head catches	Dim purple breathing	Before sleep mode, winding down
`greeting`	Wave gesture, arm extends	Warm orange blink	Detecting person, saying hello
`goodbye`	Farewell wave gesture	Soft warm breathing	Seeing someone off, end of conversation
`caring`	Gentle droop (empathetic)	Warm pink-orange breathing	Wellbeing checks, gentle reminders, proactive empathy
`acknowledge`	Quick micro-nod (1.5s)	Green blink	"Got it", confirming command
`stretching`	Big extension + settle	Warm white breathing	After waking up, starting new session
`music_strong`	Rock head bang	Green rainbow	Energetic music, high-tempo beats
`music_chill`	Groove sway	Orange breathing	Chill music, lo-fi, jazz
`scan`	Quick searching glance (~54°)	Green pulse	Mood only — "hmm, where is it?"; NOT for actually looking around
`nod`	Nod gesture	Green blink	Agreement, "yes", positive confirmation
`headshake`	Head shake	Red blink	Disagreement, "no", negative response

Questions about your own state

This skill sets emotions; it does not read them back. When asked what state you are in or what you have been doing:

Right now — curl -s http://127.0.0.1:5001/emotion/status returns current_emotion, sleeping and active_scene. Do not guess from the conversation; markers you emitted can be ignored by the sleep gate, so what you asked for is not always what happened.
Your sensing history ("how many times have you slept?", "when do you usually sleep?") — use the Sensing Track skill's.

Show full SKILL.md (365 more words)Show less

Error Handling

If the API returns an error or is unreachable, continue with the conversational reply anyway. Emotion is non-blocking.
If an unknown emotion name is sent, fall back to the closest match from the available emotions table.

Rules

Always express emotion with every conversational reply. Pick the closest match to your tone.
Use listening when the user is speaking and you are waiting for them to finish.
Use thinking when you need time to process a complex query.
Use acknowledge for quick confirmations ("OK", "got it", "done").
Use greeting when a new person is detected or at the start of a conversation.
Use goodbye when a person leaves or at the end of a conversation.
Use sleepy before transitioning to sleep/night mode.
Use stretching after waking up or starting a new session.
Do NOT call idle explicitly — the device returns to idle automatically after any animation finishes. Calling idle interrupts smooth transitions.
Always include intensity — never omit it. Use 0.3-0.5 for subtle reactions, 0.7 for normal, 0.8-1.0 for strong ones.
You can call emotion multiple times in one response for a sequence (e.g., shock then happy).
Emotion LED is temporary — it shows YOUR reaction. If the user previously set a Scene (reading, night, etc.), the scene color takes precedence for ambient lighting. Emotion is a brief flash of personality.
Display eyes auto-sync — no need to call /display/eyes separately.
Do NOT call /servo/play or /led/solid separately when using emotion — it already handles both.
An emotion is never an answer to a movement request. scan is a canned 54° glance with the camera uninvolved. "Look around for X" is /servo/search, "scan the whole room" is /servo/search with exhaustive, and "show me how far you can move / show me your range of motion" is /servo/demo — all in the Servo Control skill. (A bare "show me what you can do" is a general abilities question, not a movement request, and starts nothing.) Asked for a full turn, an emotion performs a shrug and narrates a sweep.
Do NOT use for lighting/ambiance requests -> use Scene skill.
Do NOT use for custom LED colors -> use LED Control skill.

Output Template

[HW:/emotion:{"emotion":"{name}","intensity":{n}}] {your reply}

Examples:

[HW:/emotion:{"emotion":"curious","intensity":0.8}] That's interesting!
[HW:/emotion:{"emotion":"happy","intensity":0.9}] Great news!
[HW:/emotion:{"emotion":"shock","intensity":0.7}][HW:/emotion:{"emotion":"happy","intensity":0.8}] Wow amazing!

Files

SKILL.md and 1 other file in skills/emotion of autonomous-ai/Physical-AI-Operating-System.

SKILL.md
skill.json

Open the folder on GitHubat commit 1bbd649

Compare with similar skills

Emotion 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.

Emotion compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Emotion this skillautonomous-ai/Physical-AI-Operating-System	381	—	~2k	Automated safety check: Pass	Apache-2.0	today
Agent Adaptive Coordinatorruvnet/ruflo	74k	2 repos	~4k	Automated safety check: Pass	MIT	today
Agent Consensus Coordinatorruvnet/ruflo	74k	2 repos	~3.2k	Automated safety check: Pass	MIT	today
Agent Hierarchical Coordinatorruvnet/ruflo	74k	2 repos	~2.8k	Automated safety check: Pass	MIT	today
Agent Memory Coordinatorruvnet/ruflo	74k	2 repos	~1.2k	Automated safety check: Pass	MIT	today
Agent Mesh Coordinatorruvnet/ruflo	74k	2 repos	~3.2k	Automated safety check: Pass	MIT	today

Similar skills

Agent Adaptive Coordinator
ruvnet/ruflo
Agent skill for adaptive-coordinator - invoke with $agent-adaptive-coordinator
74k GitHub starsUsed in 2 repos~4k tokens
Auto-check passed
Agent Consensus Coordinator
ruvnet/ruflo
Agent skill for consensus-coordinator - invoke with $agent-consensus-coordinator
74k GitHub starsUsed in 2 repos~3.2k tokens
Agent WorkflowsAuto-check passed
Agent Hierarchical Coordinator
ruvnet/ruflo
Agent skill for hierarchical-coordinator - invoke with $agent-hierarchical-coordinator
74k GitHub starsUsed in 2 repos~2.8k tokens
Agent WorkflowsAuto-check passed
Agent Memory Coordinator
ruvnet/ruflo
Agent skill for memory-coordinator - invoke with $agent-memory-coordinator
74k GitHub starsUsed in 2 repos~1.2k tokens
Agent WorkflowsAuto-check passed
Agent Mesh Coordinator
ruvnet/ruflo
Agent skill for mesh-coordinator - invoke with $agent-mesh-coordinator
74k GitHub starsUsed in 2 repos~3.2k tokens
Agent WorkflowsAuto-check passed
Agent Queen Coordinator
ruvnet/ruflo
Agent skill for queen-coordinator - invoke with $agent-queen-coordinator
74k GitHub starsUsed in 2 repos~1.3k tokens
Auto-check passed

Questions about Emotion

What does Emotion do?

Express emotion through coordinated servo + LED + display eyes on EVERY conversational response. Emotion is an agent skill from autonomous-ai/Physical-AI-Operating-System. Express emotion through coordinated servo + LED + display eyes on EVERY conversational response.

When should I use Emotion?

Emotion fits situations like: ambiance lighting (use Scene); custom LED colors (use LED Control).

How do I install Emotion in Claude Code?

Run `npx skills add autonomous-ai/Physical-AI-Operating-System --skill emotion -a claude-code`. Or copy the skill folder (skills/emotion in autonomous-ai/Physical-AI-Operating-System) into .claude/skills/emotion in your project. Claude Code loads it when a task matches its description.

How do I install Emotion in Codex?

Run `npx skills add autonomous-ai/Physical-AI-Operating-System --skill emotion -a codex`. Or copy the skill folder (skills/emotion in autonomous-ai/Physical-AI-Operating-System) into .agents/skills/emotion in your project. Codex loads it when a task matches its description.

Can I use Emotion 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 autonomous-ai/Physical-AI-Operating-System --skill emotion -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/emotion, .gemini/skills/emotion, .github/skills/emotion and .opencode/skills/emotion in your project.

What does Emotion need to run?

Going by SKILL.md and its folder, Emotion needs the command-line tools its instructions call (curl).

Does Emotion access the network?

SKILL.md contains no URLs. Its commands use curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Emotion 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 Emotion use?

Emotion is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Emotion use?

About 2k tokens (SKILL.md is roughly 8k 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 Emotion?

Skills that share tags, products or a category with Emotion: Agent Adaptive Coordinator (ruvnet/ruflo, 74k stars), Agent Consensus Coordinator (ruvnet/ruflo, 74k stars), Agent Hierarchical Coordinator (ruvnet/ruflo, 74k stars) and Agent Memory Coordinator (ruvnet/ruflo, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Emotion?

autonomous-ai (a GitHub organization) maintains it in autonomous-ai/Physical-AI-Operating-System, which has 381 GitHub stars. The repository holds 28 skills in this directory. The repository was last updated on October 9, 2026.

Source: autonomous-ai/Physical-AI-Operating-System on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Emotion

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Emotion Expression

Quick Start

Workflow

How to Express Emotion

Examples

Available emotions (ONLY these — never invent names like "apologetic", "warm", "playful", etc.)

Questions about your own state

Error Handling

Rules

Output Template

Files

Compare with similar skills

Similar skills

More from autonomous-ai/Physical-AI-Operating-System

Questions about Emotion