create-heartflow

Generate and manage stage-aware dating personas from archetypes or exported chat materials.

11|3|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/BboTTM/heartflow-skill --skill create-heartflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-heartflow
Source: https://github.com/BboTTM/heartflow-skill/tree/main
Command: npx skills add https://github.com/BboTTM/heartflow-skill --skill create-heartflow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pypinyin.

What problem does it solve?

This Skill helps you create a stage-aware dating persona (archetype-based or real-person reconstructed) and keep immersive interactions consistent across the full relationship lifecycle.

Core Features & Use Cases

  • Archetype-based persona creation: Generate relationship objects by combining relationship style, zodiac, and MBTI for rapid practice and controlled progression.
  • Real-person reconstruction: Rebuild an interactive persona from chats, screenshots, docs, and exported social chat logs, then evolve it with new materials and corrections.
  • Stage and scene aware runtime: Run immersive dialogue by default and switch to strategy analysis only when explicitly requested, covering stages like meet/know/warm up/flirt/confess/commit/dating and scenarios like daily/arguing.

Quick Start

Create a HeartFlow persona by telling the AI to run /create-heartflow and follow the prompts to choose archetype or real-person and the starting stage.

Frequently Asked Questions about create-heartflow

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

FAQPage Schema
How do I generate a dating simulation persona from exported chat logs?

To generate a dating simulation persona from chat logs, trigger the /create-heartflow command and select the real-person reconstruction option. The Skill analyzes your exported social chat materials, screenshots, and documents to rebuild an interactive persona for relationship roleplay.

Can I create an archetype-based dating persona without providing real chat history?

You can create an archetype-based dating persona without chat history by combining relationship style, zodiac, and MBTI traits. This allows rapid practice and controlled progression through relationship stages without needing real-person data.

How does stage progression work in relationship roleplay simulations?

Stage progression in relationship roleplay works by maintaining a stage-aware runtime that tracks interaction phases like meet, know, warm up, flirt, confess, commit, and dating. The persona adapts its dialogue behavior based on the current stage and scenario, such as daily or arguing.

Can I rollback or update a generated relationship roleplay persona?

You can rollback or iteratively update a generated relationship roleplay persona by referencing its unique slug identifier. This allows you to apply corrections or evolve the persona with new materials without regenerating it from scratch.

Do I need pypinyin installed to run the create-heartflow Skill?

Yes, you need pypinyin installed as a required dependency to run the create-heartflow Skill. This library supports the processing logic necessary for generating and managing the stage-aware dating simulation persona.

When does the dating simulation persona switch from immersive dialogue to strategy analysis?

The dating simulation persona switches from immersive dialogue to strategy analysis only when explicitly requested via a triggered command. By default, it maintains immersive interaction, ensuring strategy debriefs occur exclusively through command-triggered strategy switching rules.