story-roleplay

Extract character cards and world info from PNG, WebP, or JSON sources into JSON.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/gerald-ica/opencode-config-snapshot --skill story-roleplay-gerald-ica
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: story-roleplay
Source: https://github.com/gerald-ica/opencode-config-snapshot/tree/main/opencode/skills/story-roleplay
Command: npx skills add https://github.com/gerald-ica/opencode-config-snapshot --skill story-roleplay-gerald-ica

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Converts SillyTavern-style character cards and world info into ready-to-use JSON outputs by parsing embedded metadata from PNG/WebP images or JSON files, enabling seamless loading into your storytelling workflow.

Core Features & Use Cases

  • Automated extraction of character data and world info from PNG/WebP metadata
  • Direct JSON output for quick editing, storage, and integration with OpenCode-style tools
  • Supports world info and character books for richer roleplay prompts and dynamic interactions

Quick Start

Run the PNG/WebP or JSON parser on a character/card image to produce character.json in your workspace.

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 cards from PNG metadata for roleplay?

To extract character cards from PNG metadata, the parser reads embedded chunks using png-chunks-extract and png-chunk-text libraries to retrieve character data and output well-formed JSON for your roleplay workflow.

Can I parse SillyTavern world info from WebP images?

Yes, you can parse SillyTavern world info from WebP images. The parser supports both PNG and WebP formats, extracting embedded world data and character books to support dynamic roleplay prompts and keyword triggers.

What is the best way to convert SillyTavern character cards to JSON?

The best way to convert SillyTavern character cards to JSON is running the parser script directly on your PNG, WebP, or JSON source files to validate and output ready-to-use character.json files in your workspace.

Do I need specific libraries to parse character cards locally?

Yes, parsing character cards locally requires the png-chunks-extract and png-chunk-text libraries installed in your environment to read embedded metadata from image files and produce valid JSON outputs.

What happens when parsing unsupported character card formats?

When parsing unsupported character card formats, the parser handles the error by providing clear feedback, ensuring you know exactly which formats are compatible for extracting roleplay character data and world info.

Does the SillyTavern character parser support keyword triggers?

Yes, the SillyTavern character parser supports keyword triggers by extracting world info and character books from metadata, enabling dynamic prompt integration for real-time roleplay conversations.