waifu-stories

Generate waifu character definitions in JSON and Markdown from a concept.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/gonggqing/waifus-workflow --skill waifu-stories
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: waifu-stories
Source: https://github.com/gonggqing/waifus-workflow/tree/main/.agents/skills/waifu-stories
Command: npx skills add https://github.com/gonggqing/waifus-workflow --skill waifu-stories

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a compact engine to craft structured, machine-readable waifu character definitions in JSON and Markdown, enabling consistent world-building and easy pipeline integration.

Core Features & Use Cases

  • Generates a complete waifu definition with a character core (name, description, tags, background_story, initial_message, seed_chat, language) and one or more scenes (name, description, initial_message, content).
  • Outputs a Markdown file suitable for human reading and a JSON payload suitable for programmatic loading into a chat platform or agent.
  • Useful standalone or as part of the create-waifu workflow to rapidly convert concepts into production-ready character profiles.

Quick Start

Provide a character concept (name, archetype, tone, and 1–2 scenes) and request a full waifu JSON/Markdown definition.

Frequently Asked Questions about waifu-stories

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

FAQPage Schema
How do I generate structured JSON and Markdown character profiles from a concept?

To generate structured character profiles, provide a character concept including name, archetype, tone, and scenes. The skill outputs a complete definition with a character core and scenes, enforcing exact JSON schema syntax for programmatic loading.

What fields are required in a JSON character definition for chat platforms?

Required JSON character definition fields include a character core with name, description, tags, background_story, initial_message, seed_chat, and language, plus scenes with name, description, initial_message, and content.

Can I use this skill standalone or does it require a specific workflow?

You can use this skill standalone to generate character profiles or integrate it as part of the create-waifu workflow. Both methods rapidly convert concepts into production-ready character definitions.

Does the generated Markdown output match the JSON schema exactly?

The Markdown output is designed for human reading, while the JSON payload enforces exact schema syntax for programmatic loading. Both outputs represent the same complete character profile and scenes.

How to ensure valid JSON syntax when creating waifu character definitions?

To ensure valid JSON syntax, the generation engine automatically enforces the exact JSON schema for character core and scenes. It applies proper field limits to produce machine-readable output for pipeline integration.