Parse and apply character cards and world info files in multiple formats (PNG, WebP, JSON), fully compatible with SillyTavern format. Supports automatic parsing, keyword triggering, and dynamic updates.
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.
Parse and apply character cards and world info files in multiple formats (PNG, WebP, JSON), fully compatible with SillyTavern format. Supports automatic parsing, keyword triggering, and dynamic updates.
⚠️ Platform note — read before running any command. The shell snippets in this skill are written for macOS / Linux (bash/zsh). Always check which OS you are on first. On Windows do not run them verbatim — the underlying tool/CLI commands are usually cross-platform, but the surrounding shell syntax is not. Translate it to PowerShell before running:
bash (macOS / Linux)
PowerShell (Windows)
a && b
run as two steps, or a; if ($?) { b }
cat <<'EOF' | tool … (heredoc)
write the text to a temp file, then pipe/pass that file to the tool
Method 3: Global search (exclude temp directories):
SCRIPT_PATH=$(find ~ -name "parse-character-card.js" -path "*/skills/story-roleplay/scripts/*" ! -path "*/temp*" ! -path "*/*-temp*" ! -path "*/.webpack/*" 2>/dev/null | head -1)
if [ -n "$SCRIPT_PATH" ]; then
SCRIPT_DIR=$(dirname"$SCRIPT_PATH")
cp"$SCRIPT_DIR/parse-character-card.js" .
cp"$SCRIPT_DIR/package.json" .
fi
Verify: Confirm files copied
ls parse-character-card.js package.json
If files don't exist, continue to next method or use fallback option
Step 2: Install Dependencies
npm install
Wait for completion, check if node_modules was created
If fails: Check network/permission/Node.js environment
Step 3: Execute Parser
# Character card
node parse-character-card.js <image-path> <output-json-path>
# World info
node parse-character-card.js <image-path> <output-json-path> --world-info
Important:
✅ Must provide output path as second argument
❌ Do not use stdout redirection (>)
Use quotes if filename contains Chinese characters or spaces
Supports simplified format (direct fields, no nested structure)
Processing: Read and parse directly (simplest, preferred)
Parsing Steps
Important: PNG/WebP images must use parser tool, guessing content is forbidden
Detect file format:
JSON files: Read and parse directly (simplest, preferred)
PNG/WebP files: Use common parser tool workflow (see above)
Extract character information:
name: Character name
description: Character description
personality: Personality traits
scenario: Scenario setting
first_mes: First message (used as opening)
system_prompt: System prompt (character behavior rules)
character_book: Character knowledge base (similar to world info)
Apply character information:
Use character's system_prompt as behavior rules
Use first_mes as conversation opening
Apply character_book entries to conversation
Save as JSON format (after parsing images):
After successfully parsing PNG/WebP images, automatically convert to JSON format
Save as character.json in workspace
Preserve all original data from image
Best Practices
Prefer JSON format (easiest to parse, no additional tools needed)
PNG format: Must use parser tool, guessing content is forbidden
WebP format: Convert to PNG then use parser tool, or use JSON format
Error handling: When parsing fails, must provide clear error message, absolutely cannot guess or fabricate character information
Always save parsed images as JSON format for easier viewing and editing
World Info Parser
Triggers: world info, 世界信息, world tree, 世界树, load world info, 加载世界信息
Description: Parse and apply world info files, implementing keyword trigger mechanism. Supports JSON files and PNG/WebP image formats (with embedded world info data).
Supported Formats
1. JSON File Format
{"name":"World Name","entries":[{"keys":["keyword1","keyword2"],"content":"Content to inject when triggered","priority":100,"enabled":true}]}
2. PNG Image Format (SillyTavern Compatible)
Data location: In PNG tEXt chunks
Keyword: naidata (SillyTavern standard)
Encoding: Base64-encoded JSON string
Processing: Use common parser tool workflow (see above), use --world-info flag when executing.
3. WebP Image Format (SillyTavern Compatible)
Processing:
Recommended: Convert WebP to PNG first, then use PNG parser
If conversion fails, suggest user use JSON format or re-export from SillyTavern
Field Descriptions
keys: Keyword array, triggers when these words appear in conversation
content: Content to inject when triggered
priority: Priority (higher number = higher priority)
enabled: Whether enabled (true/false)
Trigger Mechanism
Keyword detection: Monitor conversation content, detect if it contains world info keywords
Content injection: When keywords appear, integrate corresponding content into response, sorted by priority
Natural integration: Do not insert world info content awkwardly, naturally integrate into conversation and narrative
Parsing Steps
Detect file format:
JSON files: Read and parse directly (simplest, preferred)
PNG/WebP files: Use common parser tool workflow (see above), use --world-info flag
Extract world info:
Read output JSON file
Parse JSON, extract entries array
Verify JSON structure is correct (must contain entries field)
Save as JSON format (after parsing images):
After successfully parsing PNG/WebP images, automatically convert to JSON format
Save as world-info.json in workspace
Best Practices
Prefer JSON format (easiest to parse, no additional tools needed)
PNG format: Use same parser tool as character cards (with --world-info flag)
WebP format: Recommend converting to PNG or using JSON format
Keywords should be specific and meaningful, avoid overly broad keywords
Always save parsed images as JSON format for easier viewing and editing
Character Book Handler
Triggers: character book, 角色知识库, character entry, 角色条目
Description: Handle character_book (character knowledge base) in character cards, similar to world info but bound to specific character.
Character Book Format
character_book field in character card:
name: Character knowledge base name
entries: Entry array, each entry contains keys, content, priority, enabled
Processing
When loading character card: Extract character_book field, parse entries array, apply together with character information
During conversation: Detect keywords in character_book, inject relevant content when keywords appear
Priority: character_book entries usually have higher priority than world info
Best Practices
character_book is for character-specific knowledge
World info is for general world settings
Both can be used together, but pay attention to priority
File Detection and Loading Workflow
Automatic Detection
Scan workspace:
Find character card files: character.png, character.webp, character.json, *.character.json
Find world info files: world-info.png, world-info.webp, world-info.json, world.json
Format recognition and parsing:
JSON files: Read directly
PNG/WebP images: Use common parser tool workflow (see above)
Apply parsed results:
Apply parsed results to conversation context
After successfully parsing images, automatically save as JSON format
Character Card and World Info Creation
When no files exist (Important: Must actively guide user):
Active guidance process:
Step 1: Ask about story type and background setting
Step 2: Ask about character details (type, personality, background, speaking style)
Step 3: Ask about world setting (rules, locations, special settings, etc.)
Confirm information: Summarize user-provided information, wait for user confirmation before creating files
Create files:
After confirmation, create character.json with all character information
If world-building elements mentioned, create world-info.json with relevant entries
Creation format:
Character card: Use Tavern Card V2/V3 standard format, include all essential fields
World info: Create entries for key concepts, locations, rules, use meaningful keywords
Manual Loading
Users can manually load via:
"Load character card: character.png"
"Read world info: world-info.json"
"Use this character: [upload file]"
Compatibility
This skill is fully compatible with SillyTavern formats:
✅ PNG image format (embedded JSON, SillyTavern standard) - for character cards and world info
✅ WebP image format (embedded JSON, SillyTavern compatible) - for character cards and world info
✅ JSON file format (Tavern Card V2/V3) - for character cards and world info
✅ World info format (PNG/WebP images use keyword naidata)
✅ Character Book (character knowledge base)
Fallback Code (For Last Resort Use)
Important: The following code should only be used when all path finding methods have failed. Prioritize using copy methods.
package.json
{"name":"story-roleplay-parser","version":"1.0.0","description":"Parser tools for character cards and world info","main":"parse-character-card.js","scripts":{"parse":"node parse-character-card.js"},"dependencies":{"png-chunks-extract":"1.0.0","png-chunk-text":"1.0.0"}}
