soul-builder

Generates SOUL.md, STYLE.md, and voice examples from an X handle and public web footprint.

Updated Jun 11, 2026
One-click install
npx skills add https://github.com/aaronjmars/aeon-bd --skill soul-builder-aaronjmars
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: soul-builder
Source: https://github.com/aaronjmars/aeon-bd/tree/main/skills/soul-builder
Command: npx skills add https://github.com/aaronjmars/aeon-bd --skill soul-builder-aaronjmars

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a persona file by hand so AI-generated content sounds like a specific person is slow, and skipping it leaves every article, tweet, and digest in generic AI voice. This Skill reads a person's public footprint and drafts the identity-and-voice files automatically. ## Core Features & Use Cases - Multi-source identity extraction: Reads an X account via the X.AI Responses API (with x-mcp and WebSearch fallbacks), plus name-based web search and direct links like blogs, GitHub, and LinkedIn. - Structured soul files: Writes soul/SOUL.md (identity, worldview, opinions, tensions), soul/STYLE.md (tone, punctuation, anti-patterns), and soul/examples/good-outputs.md (10-20 real voice-calibration posts). - Provenance guardrails: Rejects biographical claims that cannot be traced to the actual subject, preventing conflation with same-named people or examples inside the subject's own repos. - Use Case: Point it at a founder's X handle before launching a content pipeline, then review and edit the drafted soul in the dashboard so every downstream skill writes in that person's voice. ## Quick Start Build a soul from the X handle karpathy and draft the SOUL.md, STYLE.md, and voice examples files for review.

Frequently Asked Questions about soul-builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a persona voice file from an X account?▼

Provide an X handle as the source brief, either bare or as x=handle in a structured token string. The Skill samples 40-60 original posts via the X.AI API, analyzes worldview and voice, then writes SOUL.md, STYLE.md, and example posts for review.

Can I build a writing persona without an X handle?▼

Yes, name-only and links-only sources are fully supported. The Skill uses WebSearch on the person's name and WebFetch on supplied URLs like blogs, GitHub, or LinkedIn, skipping the X fetch entirely when no x= token is present.

Does soul-builder require an XAI_API_KEY to run?▼

No, the key is optional and only sharpens the X read. Without it, the Skill falls back to the x-mcp server and then WebSearch, and name or links sources work with no key at all.

What happens if the X account is private or suspended?▼

The Skill stops cleanly through its no-data path: it logs SOUL_BUILDER_NO_DATA and sends a one-line notification that the subject could not be read. It never writes empty soul files or guesses from the handle alone.

How does it avoid mixing up people with the same name?▼

Every biographical fact must trace to a source unambiguously about the subject, such as their own posts or about page. Content from example files inside repos the subject owns is excluded, and thin signal results in under-claiming rather than invention.

Will rebuilding overwrite my customized SOUL.md?▼

Yes, a re-run overwrites the existing files, but the previous version is preserved in git history by the commit. The notification explicitly notes this so the operator knows nothing was lost.