storyworld

name	storyworld
description	Agent entrypoint for the PolyU Storyworld: load character profiles and reference images directly from the GitHub repo and HuggingFace dataset, store them under story/characters/, and provide a simple CLI/API for other skills to call. Replaces mcporter-first workflow with a Git-first workflow.

storyworld skill

This skill is the primary entrypoint for storyworld operations. Its responsibilities:

• Clone or pull the canonical GitHub repository (https://github.com/venetanji/polyu-storyworld) into the workspace (under story/repo/).
• Load character YAML files from the repo and save them into story/characters// (CHARACTER.yaml, refs).
• Download reference images from the HuggingFace dataset (https://huggingface.co/datasets/venetanji/polyu-storyworld-characters) into story/characters//refs/.
• Provide a small CLI script to fetch a character by code, prepare the local workspace, and print a JSON summary with paths to the saved files.
• Offer a fallback to call MCP via mcporter if a special MCP-only asset is requested (dual-mode optional).

Paths used by this skill (workspace-relative):

• story/repo/ — cloned polyu-storyworld Git repo
• story/characters// — per-character folder
• story/characters//CHARACTER.yaml — raw character YAML
• story/characters//refs/ — downloaded reference images

CLI example:

python skills/storyworld/scripts/fetch_character.py --code 6166r --repo https://github.com/venetanji/polyu-storyworld --hf-dataset https://huggingface.co/datasets/venetanji/polyu-storyworld-characters

Return format (JSON):

{
  "code": "6166r",
  "yaml": "story/characters/6166r/CHARACTER.yaml",
  "refs": ["story/characters/6166r/refs/6166r_ref.png"],
  "repo_path": "story/repo"
}

Security & notes:

• By default this skill performs only Git clones and HTTP downloads — no remote code execution.
• If you want MCP fallback, mcporter will be invoked only if the --use-mcp flag is passed and mcporter is present on PATH.

Implementation files

• skills/storyworld/scripts/fetch_character.py — small, robust Python script used by the skill.