Claude Info
AI и агенты

soul.md

aaronjmars/soul.md

Инструмент для построения «души» AI-агента на основе ваших текстов, твитов и заметок. Claude Code анализирует данные, извлекает голос и мировоззрение, генерирует markdown-файлы, которые любой LLM может загрузить и писать в вашем стиле.

Установка

terminal
bash
git clone https://github.com/aaronjmars/soul.md.git

README


Что это такое?

Файл души фиксирует, кто вы есть, в формате, который AI-агенты могут воплощать. Не чат-бот, который рассказывает о вас — AI, который думает и говорит как вы.

Сложите свои твиты, эссе и посты в папку. Агент прочитает всё, извлечёт ваше мировоззрение и голос, и создаст набор markdown-файлов, которые любой LLM сможет загрузить, чтобы писать как вы.

Цель: человек, читающий ваш SOUL.md, должен уметь предсказывать вашу реакцию на новые темы. Если не может — файл слишком расплывчатый.

Сценарии использования:

  • Генерировать идеи исходя из вашего мировоззрения
  • Создавать контент (твиты, статьи, письма), звучащий как вы
  • Адаптировать AI под ваши интересы и паттерны мышления
  • Масштабировать себя для контента, ответов, мозговых штурмов

Быстрый старт

Вариант 1 — Построить с нуля

/soul-builder

Агент проводит интервью: мировоззрение, мнения, стиль письма, что для вас важно.

Вариант 2 — Построить из ваших данных

Поместите контент в data/:

data/x/ ← экспорт Twitter/X data/writing/ ← посты в блоге, эссе

Затем запустите /soul-builder. Агент анализирует данные, извлекает паттерны и создаёт черновик файла души. Вы вместе просматриваете и дорабатываете его.

Вариант 3 — Вручную

Скопируйте шаблоны и заполните их:

SOUL.template.md → SOUL.md STYLE.template.md → STYLE.md SKILL.template.md → SKILL.md

Лучше всего использовать с Aeon

Aeon — автономный агент на GitHub Actions, работающий на Claude Code. 68 скиллов для исследований, инструментов разработки, мониторинга крипты и продуктивности — всё работает в фоне по расписанию cron.

Файлы души напрямую встраиваются в Aeon. Скопируйте свою душу в папку soul/ в репозитории Aeon, добавьте несколько строк в CLAUDE.md — и каждый скилл, который запускает Aeon (статьи, дайджесты, твиты, исследовательские брифы), будет написан вашим голосом. Никакой настройки на уровне отдельных скиллов. Идентичность распространяется автоматически.

Почему это сочетание работает:

  • Aeon управляет когда и что — расписание, исследования, мониторинг, генерация контента
  • Файлы души управляют кто — голос, мировоззрение, мнения, стиль
  • Вместе вы получаете фонового агента, который не просто работает на вас — он звучит как вы

Настройка занимает 2 минуты. Подробности — в разделе Soul документации Aeon.


Источники данных

Передайте билдеру всё, что вы когда-либо писали. Чем больше сигнала — тем точнее результат.

КатегорияПлатформы
Социальные сетиTwitter/X, Bluesky, Farcaster, Mastodon, Threads, LinkedIn, Reddit
ТекстыSubstack, Medium, Ghost, WordPress, Mirror.xyz, Paragraph.xyz
МессенджерыDiscord, Telegram, Slack, экспорт iMessage
ЗаметкиNotion, Obsidian, Roam Research, Logseq, Apple Notes
Видео/Аудиотранскрипты YouTube, транскрипты подкастов, записи Loom
Код/Разработкаактивность на GitHub, комментарии на Hacker News, ответы на Stack Overflow
ПрочееPDF, plain text, CSV/JSON, RSS-ленты, GDPR-экспорты данных

Нет существующих данных? Вариант 1 (режим интервью) всё равно создаёт полноценный файл души с нуля.


Совместимые фреймворки

Файлы души — это обычный markdown: если агент умеет читать файлы, он может воплощать вас. Протестировано с:

ФреймворкЯзыкЗвёзды
AeonYAML/Markdown
OpenClawTypeScript322k
NanobotPython34.6k
ZeroClawRust27.8k
PicoClawGo25.3k
NanoClawTypeScript24k
OpenFangRust14.9k
IronClawRust10.4k
Hermes AgentPython8.7k
Claude Code · OpenCode · Codex · Gooseразличные

Также работает с любой моделью через системный промпт — см. раздел Использование с другими инструментами.


Структура файлов

your-soul/ ├── SOUL.md ← Кто вы (идентичность, мировоззрение, мнения) ├── STYLE.md ← Как вы пишете (голос, синтаксис, паттерны) ├── SKILL.md ← Режимы работы (твит, эссе, чат и т.д.) ├── MEMORY.md ← Память сессий для непрерывности между разговорами ├── data/ ← Исходные материалы │ ├── writing/ │ ├── x/ │ └── influences.md └── examples/ ├── good-outputs.md └── bad-outputs.md

Что делает файл души хорошим

ХорошоПлохо
«Я считаю, что большинство дискуссий об AI safety — это galaxy-brained cope»«У меня нюансированные взгляды на AI»
«Я по умолчанию сначала не соглашаюсь, потом ищу стальной аргумент»«Мне нравится рассматривать разные точки зрения»
Конкретные ссылки на книги, названные источники влияния«Я много читаю»
Реальные острые мнения с обоснованием«Я стараюсь быть сбалансированным»

У реальных людей бывают противоречивые взгляды. Включайте противоречия — именно они делают вас узнаваемым.


Использование вашей души

После создания вызовите свою душу:

/soul

Или укажите любому LLM на вашу папку и попросите прочитать:

  1. SOUL.md — идентичность
  2. STYLE.md — голос
  3. MEMORY.md — недавний контекст
  4. examples/ — калибровка
  5. data/ — основа при необходимости

Значимые события добавляются в MEMORY.md, обеспечивая непрерывность вашей души между сессиями.

Похожие скиллы