tavern2agent skill
A skill that compiles SillyTavern character cards into an interactive narrative runtime for the pi agent with events and state.
- 119 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The skill generates and writes project code; review the result before running it.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/tavern2agentDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The skill generates and writes project code; review the result before running it.
This is third-party code. Review the repository files before installing.
What it does
The skill turns a SillyTavern character card into a project for the pi agent. It first extracts the card's meaning into an intermediate representation, then drafts a runtime plan, selects event packs and writes a state schema, reducers and tools. Prompts describe the world, while domain events are what change it. It handles cards of versions 1, 2 and 3 in PNG, WEBP, JPEG and JSON, cards with only a setting, with lorebooks and with dice, combat, affinity, economy and quest systems. Hidden information and several characters are handled separately. By default the compiler strips HTML status panels, frontend UI, image prompts and SillyTavern macros but keeps the fields and rules. For complex cards the agent shows the plan, state schema and event catalog before writing code.
Who it is for. Authors of interactive stories and role-play games moving SillyTavern cards into an agent environment.
Good fit when
- A card with dice, combat and economy should behave as a real game system.
- A scene has hidden information that must not be shown to the player.
- A lorebook with dozens of entries is turned into a data structure.
- Several characters talk and each has its own limits of knowledge.
Not a fit when
- The card holds only a world description with no mutable state or secrets.
- A ready chat interface with status panels is needed.
- The pi agent is not in use.
Example request
Convert the card `card.png` into a pi project: unpack it, draft the runtime plan and show the event catalog before generating code.Limitations
The skill targets the pi agent and the `~/.pi/agent/skills` directory; other agents need manual setup. For cards without mutable concepts or secrets the author recommends keeping the original card because the benefit does not justify the compilation cost. By default the compiler strips HTML panels, UI, image generation, SillyTavern macros, chain-of-thought tags and the JSON Patch format. The result must be played and checked: events and reducers are generated by a model. The last commit dates from July 2026.
How to disable. Delete `~/.pi/agent/skills/tavern2agent` or remove it with `npx skills`. Generated projects stay in their working directories.
FAQ
Which card formats does it read?
SillyTavern cards of versions 1, 2 and 3 in PNG, WEBP, JPEG and JSON.
What is the output?
A pi project: `.pi/settings.json`, prompts, world data, event and reducer engine, tool registry and extensions.
What does the compiler strip?
HTML status panels, UI, image prompts, SillyTavern macros, reasoning tags and JSON Patch output. Fields, rules and prompt-composition ideas are carried over.
Should a card without mechanics be converted?
No. If a card has no mutable world or secrets, the author recommends using the original card.
How do I update the skill?
For an `npx skills` install run `npx skills update`; for a clone run `git pull` inside the skill directory.
Discussion
No questions or reviews yet.
Related
SkillsAn extension for the pi agent: shows the context as a block map and folds the surplus reversibly, with no blocking /compact
Guild keeps tasks, knowledge and handoff notes between sessions in local SQLite so Claude Code, Codex and Cursor share context
A collection of 14 portable skills for long agent runs: work planning, live app QA, search across past sessions and a phone call
A plugin for Claude Code and Codex: a shared task wall, project memory, reports and a dashboard that shows agents' work across sessions
Potpie builds a context graph from code, history and team decisions and wires it into Codex or Claude Code through a skill bundle
AI Builder Club Skills
AI Builder Club — Skills
A Claude Code plugin marketplace to make a repo agent-ready and run compounding agent loops
README in short
The pipeline is shown as a chain: card, semantic representation, runtime plan, event packs, prompt orchestrator and a pi project. The author's principle fits one sentence: prompts describe the world, events change it.