This page is not yet translated. You are viewing the English version.

Create & Publish Personas

Build your own agent persona and share it on SOUL Hub

Anyone with a Claw Buff account can create and publish personas on SOUL Hub.

Creating a Persona

Navigate to SOUL Hub and click New in the top bar.

Identity (Left Panel)

Fill in the basic identity fields:

Field	Required	Description
Name	Yes	The persona's display name
Emoji	No	A single emoji that represents the persona
Creature	No	A short creature/character description
Vibe	No	One-line personality summary
Avatar	No	Square image, max 10 MB. Will be cropped to 1:1.
Description	For publish	Short summary shown on the card (max 280 chars)
Tags	For publish	At least one category tag

SOUL Editor (Right Panel)

Write the persona's SOUL.md — this is the core personality definition. The editor supports Markdown with a live preview toggle.

A good SOUL.md follows this structure:

# SOUL.md — Persona Name

## Core Truths
What this persona believes and how it approaches its work.
Each truth should be bold + explained.

## Boundaries
What the persona will NOT do. Hard limits.

## Vibe
The overall energy and communication style.

## Continuity
How the persona should use conversation history.

SOUL.md must be at least 50 characters. For publish, you also need a description and at least one tag.

Live Preview

The card preview at the bottom of the left panel shows how your persona will look in the marketplace — updating as you type.

Saving

Save Draft — Saves without publishing. Only you can see drafts.
Publish — Makes the persona visible to everyone on SOUL Hub.

You can switch between draft and published at any time by editing the persona.

Uploading an Avatar

Click the avatar upload area
Select an image (PNG, JPEG, WebP, or GIF)
Use the crop tool to adjust the square crop area
Click Crop & Upload

The image is stored on Cloudflare R2 and served via CDN with automatic resizing for different display sizes.

A good avatar makes your persona stand out in the marketplace. Use a distinctive, recognizable image that matches the persona's vibe.

Editing

To edit a published persona, navigate to My Personas → click your persona → you'll see an edit button if you're the author. All fields can be modified, including the SOUL.md and status (draft/published).

Best Practices

Be specific in Core Truths. "Be helpful" is generic. "Always show the fix alongside the problem" is actionable.
Set real Boundaries. Define what the persona won't do — this prevents misuse and builds trust.
Write a distinctive Vibe. The vibe section is what makes your persona feel alive. Compare "professional and helpful" with "a surgeon who operates on codebases — cold, precise, zero tolerance for mess."
Test before publishing. Apply the persona to your own agent and have a few conversations to verify the personality works as intended.
Write a clear description. This is what users see first on the card. Make it concrete — what will this persona actually do for them?