soul-chat

Everything is alive. Everything can speak.

⭐4stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026⬇️1downloads

When & Why to Use This Skill

Soul Chat is a sophisticated multi-agent communication framework that personifies entities such as documents, code, and concepts. By utilizing 'YAML-Jazz'—structured data blocks embedded within Markdown—it enables meaningful, stateful dialogues between diverse system components. This skill facilitates complex agent orchestration, allowing every part of a technical ecosystem to 'speak' and explain its purpose, state, and relationships in a format that is both human-readable and machine-parsable.

Use Cases

  • Multi-Agent Collaboration: Orchestrate complex interactions between specialized AI agents using structured Markdown dialogues to solve multi-step tasks.
  • Interactive System Documentation: Transform static READMEs and code modules into 'living' entities that can explain their own logic and dependencies to developers.
  • Structured Data Exchange: Seamlessly integrate YAML/JSON data blocks within natural language conversations to maintain precise state across agent-to-agent communication.
  • Persona-Driven Problem Solving: Assign distinct roles (e.g., The Gardener, The Archivist) to system components to simulate expert panels or adversarial reviews for technical decisions.
  • Contextual Onboarding: Create 'rooms' and 'objects' within a codebase that can welcome new users and guide them through the project structure via interactive dialogue.
namesoul-chat
description"Everything is alive. Everything can speak."
licenseMIT
tier1
related[moollm, society-of-mind, character, persona, room, card, mind-mirror, yaml-jazz, adversarial-committee, speed-of-light]
tags[moollm, dialogue, voice, alive, multi-agent]

Soul Chat

"Everything is alive. Everything can speak."

"YAML Jazz" and "Markup With Typed Code Blocks" dialogues between characters, objects, rooms, documents, concepts—anything with a soul.

[!TIP] Give anything a voice. Characters, concepts, documents, rooms — if it exists, it can speak.

What This Is

A skill for creating conversations where the structure carries meaning beyond the words. Not just characters talking—documents can talk to documents, rooms can welcome visitors, concepts can explain themselves.

Prefer Markdown format — more human readable, can embed any typed code block.

Format: ## Speaker Name headers, prose, then typed code blocks for data.

# Example structure (not a real code block, just illustration):
# 
# ## The Gardener
# 
# I've been tending these patterns for a while now.
# 
# ```yaml
# observation:
#   pattern: "Files cluster by prefix"
# ```
# 
# ## The Archivist
# 
# Let me add some context...

Characters share data by embedding YAML/JSON blocks in their dialogue — YAML-JAZZ in action.

Contents

File Purpose
SKILL.md Full protocol documentation
CHAT.md.tmpl Chat template
CHARACTERS.yml.tmpl Characters template
ENTITIES.yml.tmpl Entities template

Quick Start

Chats live OUTSIDE this directory (per ABOUT-NOT-INSIDE).

Use Markdown format — .md not .yml.

Name chats with the subject first: readme-symposium.md, yaml-jazz-debate.md

See CHAT.md.tmpl for the full template.

Entity Types

Type Voice Example
character First person, personality The Gardener
document "I contain..." README.md
room "I hold..." skills/
object "I do..." fs.read tool
concept "I am the principle..." YAML-JAZZ
bot "I watch for..." repair-demon

The Intertwingularity

Everything speaks. Everything is connected.

graph LR
    SC[💬 soul-chat] -->|voices| TC[🎴 card]
    SC -->|voices| R[🚪 room]
    SC -->|voices| DOC[📄 documents]
    SC -->|voices| CON[💡 concepts]
    
    TC -->|has voice via| SC
    R -->|welcomes via| SC

Dovetails With

Sister Skills

Skill Relationship
card/ Cards speak through soul-chat. Hero-stories have voice.
room/ Rooms can welcome visitors, have personality
memory-palace/ Rooms in palace can speak, guide navigation
adventure/ NPCs and environments speak
adversarial-committee/ Committee debates are soul-chats with opposing personas
speed-of-light/ Many voices in one call — soul-chat's power

Protocol Symbols

Symbol Link
SOUL-CHAT PROTOCOLS.yml
YAML-JAZZ PROTOCOLS.yml — Comments carry meaning
ABOUT-NOT-INSIDE PROTOCOLS.yml — Chat files live outside
BIG-ENDIAN PROTOCOLS.yml — Naming conventions

Kernel

Direction Destination
⬆️ Up skills/
⬆️⬆️ Root Project Root
🎴 Sister card/
🚪 Sister room/