SoulTavern: skill pack for Hermes Agent

Import SillyTavern V2 character cards as SOUL.md personas for Hermes Agent and OpenClaw

What SoulTavern does

SoulTavern turns a SillyTavern V2 character card, in .png or .json form, into the markdown system-prompt files an agent runtime loads at session start. There are two production targets: --target hermes writes SOUL.md and HERMES.md, and --target openclaw writes SOUL.md, an AGENTS.md managed section and IDENTITY.md. It parses the card, substitutes the {{char}} and {{user}} placeholders and runs each text field through a sanitiser that strips zero-width, right-to-left override and control characters.

Each rendered file opens with an identity directive that overrides the runtime's default assistant framing, while operator-level safety stays above the persona. A library of scripts lists, switches, deletes, restores and reverts cards, with history snapshots. Cards larger than the runtime's per-file budget, 15k for Hermes and 9k for OpenClaw, trigger an agent-driven flow. It is one self-contained skill folder in Python with no third-party dependencies, and after a change you start a fresh session with /new or /reset.

Key features

Converts SillyTavern V2 .png and .json cards into SOUL.md personas
Hermes target writes SOUL.md and HERMES.md
OpenClaw target writes SOUL.md, AGENTS.md and IDENTITY.md
Sanitises zero-width, right-to-left override and control characters
List, switch, delete, restore, history and revert scripts
Handles oversized cards with an agent-driven flow

When to use it

Giving a Hermes agent a roleplay character as its persona
Switching between several imported characters without hand-editing SOUL.md
Reverting to the default persona after trying a card

Who it is for: Hermes Agent and OpenClaw users who want to reuse SillyTavern character cards as agent personas.

How it fits with Hermes Agent

Supports Hermes Agent as one of two production targets, writing SOUL.md and HERMES.md, and it can also be installed from the Hermes skills hub.

How to install SoulTavern

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

hermes skills tap add imphillip/SoulTavern && hermes skills install soultavern

Requirements: Python 3.10 or newer, standard library only

FAQ

What is SoulTavern?

SoulTavern is a skill that imports SillyTavern V2 character cards and writes them as SOUL.md persona files for agent runtimes. Hermes Agent and OpenClaw are its two production targets.

Does SoulTavern work with Hermes Agent?

Yes. With --target hermes it writes SOUL.md and HERMES.md into your Hermes home. The README says to start a fresh session with /new or /reset when a change is ready.

How do I install SoulTavern?

Run hermes skills tap add imphillip/SoulTavern && hermes skills install soultavern. You can also copy the skills/soultavern folder into your runtime's skills directory.