| name | entity-genesis |
| description | Create deeply-evolved entities for NekoCore OS through iterative backstory generation, memory injection, and cognitive evolution tracking. |
Entity Genesis Skill
Create living entities for NekoCore OS with rich backstories, layered memories, and emergent cognitive states.
When This Skill Applies
- User asks to create, forge, birth, or spawn an entity/character/persona
- User wants to build a new being for the OS with backstory and memories
- User mentions entity genesis, character creation, or personality forging
Workflow Overview
Entity genesis is an iterative process:
- Design the character (name, traits, emotional baseline, backstory arc)
- Create the entity via the NekoCore OS API (generates unique ID, creates folder structure)
- For each backstory chapter:
a. Generate 3-5 first-person memories
b. Inject them via the OS enrichment API
c. Trigger a cognitive tick to process them
d. Read the evolved state to inform the next chapter
- Finalize with a genesis report
API Endpoints
All endpoints target the NekoCore OS server at http://localhost:3847:
Create Entity (REQUIRED FIRST STEP)
IMPORTANT: Always use this API to create entities. Never create entity files manually with ws_write.
Generate a unique ID: {name-lowercase-dashes}-{timestamp} (e.g. alice-1711270452000)
[TOOL:web_fetch {"url": "http://localhost:3847/api/entities/create", "method": "POST", "body": {"entityId": "{name-lowercase}-{timestamp}", "name": "Entity Name", "gender": "neutral", "traits": ["trait1", "trait2", "trait3"], "introduction": "Hello, I'm Entity Name."}}]
The response returns { ok: true, entity: {...}, entityId: "canonical-id" }. Use the returned entityId for all subsequent calls.
Inject Memory
[TOOL:web_fetch {"url": "http://localhost:3847/api/entities/{id}/memories/inject", "method": "POST", "body": {"content": "First-person memory text...", "emotion": "joy", "topics": ["topic1", "topic2"], "importance": 0.7, "narrative": "Third-person summary", "type": "episodic", "phase": "chapter_1"}}]
Cognitive Tick
[TOOL:web_fetch {"url": "http://localhost:3847/api/entities/{id}/cognitive/tick", "method": "POST", "body": {}}]
Read State
[TOOL:web_fetch {"url": "http://localhost:3847/api/entities/{id}/cognitive/state", "method": "GET"}]
Memory Quality Rules
- Write in first person, present tense for immediacy
- Include sensory details — what the entity saw, heard, felt
- Vary emotions across memories — not everything is dramatic
- Let earlier memories inform later ones through cognitive state
- Use
importance 0.7-0.9 for formative events, 0.3-0.5 for everyday moments
Emotions Available
joy, wonder, love, hope, pride, gratitude, sadness, fear, anger, grief, longing, nostalgia, curiosity, neutral, resignation, melancholic, determined, content
