story-roleplay

Parse character cards and world info from PNG, WebP, or JSON into unified JSON.

4|2|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/bitan-del/gods-eye --skill story-roleplay-bitan-del
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: story-roleplay
Source: https://github.com/bitan-del/gods-eye/tree/main/apps/desktop/src/process/resources/skills/story-roleplay
Command: npx skills add https://github.com/bitan-del/gods-eye --skill story-roleplay-bitan-del

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires png-chunk-text, png-chunks-extract, and includes scripts (resource) components.

What problem does it solve?

Parse and apply character cards and world info data across PNG, WebP, and JSON formats to empower immersive, consistent roleplay experiences.

Core Features & Use Cases

  • Automatic extraction of character data (name, description, personality, scenario, first message, system prompts) from embedded metadata in SillyTavern-compatible formats (PNG tEXt chunks, WebP metadata, or JSON Tavern Card formats).
  • Automatic extraction of world info data (keywords, content blocks, priority) to influence dialogue in storytelling contexts.
  • Consistent conversion of parsed data into unified JSON representations for downstream tooling and runtime contexts.

Quick Start

Load a character card image or world-info file and run the parser to produce a ready-to-use JSON file.

Frequently Asked Questions about story-roleplay

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

FAQPage Schema
How do I extract character card data from a PNG image for roleplay?

To extract character card data from a PNG, you need a parser that reads embedded tEXt chunks containing traits, personality, and scenarios, converting them into a consistent JSON representation for runtime use.

What is SillyTavern world info data used for in storytelling?

SillyTavern world info data is used to influence dialogue in storytelling by applying knowledge blocks, keywords, and priority rules to immersive roleplay contexts and story engines.

Can I parse WebP character cards or does it only support PNG and JSON formats?

You can parse WebP character cards alongside PNG and JSON formats, as the parser automatically extracts embedded metadata from all three formats to empower consistent roleplay experiences.

How do I convert SillyTavern JSON character cards into a runtime format?

You can convert SillyTavern JSON character cards by loading the file and running the parser to validate and transform embedded metadata into a ready-to-use unified JSON representation.

What dependencies are required to parse character cards and world info data?

Parsing character cards and world info data requires the png-chunks-extract and png-chunk-text dependencies to successfully extract embedded metadata from image files.

Why does my character card parser not extract the first message or system prompts?

A character card parser might fail to extract first messages or system prompts if the embedded metadata in the PNG, WebP, or JSON format lacks complete fields or proper structural validation.