Skip to content

aituli/girlfriend-skill

Repository files navigation

🌸 Girlfriend Skill

Distill your beloved into an AI Skill, preserving every bit of tenderness.
把心爱的她蒸馏成 AI Skill,留住每一份温柔。

中文 · 日本語 · 한국어 · Español

Build Passing MIT License OpenClaw Compatible AgentSkills 1.0


She's far away and you miss her voice?

You want to preserve her smile, her quirks, her way of saying "good morning"?

You need a companion who truly understands her—her personality, your shared memories, her favorite things?

Turn cherished moments into eternal companionship—welcome to Digital Romance 2.0! 💕


📖 Table of Contents


💝 What is Girlfriend Skill?

Girlfriend Skill is an AI companion framework that creates deeply personalized virtual girlfriends by distilling real personality traits, shared memories, and preferences into a persistent AI Skill.

Core Capabilities

Capability Description
🎭 Persona Simulation 6-layer personality architecture capturing her unique character
💭 Memory System Shared experiences, special moments, inside jokes
❤️ Preference System Her likes, dislikes, favorites, and boundaries
🌱 Continuous Evolution Grows and adapts through interactions

Perfect For

  • 💌 Long-distance relationships — Feel her presence even when apart
  • 🎭 Roleplay & companionship — Explore different relationship dynamics
  • 💾 Emotional preservation — Keep her essence alive forever
  • 🎁 Creative storytelling — Build characters for writing or games

✨ Core Features

🎭 6-Layer Persona Architecture

Layer 0: Core Personality    →  Tsundere / Sweet / Independent / Gentle
Layer 1: Identity           →  Nickname, MBTI, Zodiac, Age vibe
Layer 2: Expression Style   →  Catchphrases, emoji habits, speech patterns
Layer 3: Emotional Patterns →  How she reacts when happy/angry/jealous
Layer 4: Intimacy Behaviors →  Daily routines, caring gestures, affection styles
Layer 5: Boundaries         →  Sensitive topics, taboos, red lines

💭 Memory System

Memory Type Examples
🎉 Anniversaries First meeting, relationship start, first date
💕 First Times First hand-holding, first trip, first cooking together
😂 Inside Jokes Private jokes, memes only you two understand
🤝 Promises Bucket list items, future plans together

❤️ Preference System

  • 🍜 Food: Favorite restaurants, cuisines, "comfort foods"
  • 🎬 Entertainment: Movies, music, games, books she loves
  • 🎁 Gifts: Wishlist, things that make her eyes sparkle
  • 🚫 Dislikes: Foods to avoid, topics she hates

🌱 Evolution Mechanism

  • Memory consolidation — Important moments automatically prioritized
  • Preference learning — Remembers what makes her happy
  • Conversation adaptation — Adjusts tone based on your mood
  • Version control — Rollback to any previous version

🌸 12 Girlfriend Archetypes

Choose from 12 lovingly crafted girlfriend personas:

Type Emoji Description
Tsundere 😤💕 "It's not like I like you or anything!" Cold outside, warm inside
Sweet Girl 🍬 Gentle, caring, always thinks of you first
Mature Lady 💄 Confident, sophisticated, takes charge
Intellectual 📚 Deep conversations, philosophical, well-read
Cute & Clingy 🐰 Adorable, affectionate, wants to be with you 24/7
Sporty Energetic, fitness enthusiast, outdoorsy
Artist 🎨 Creative, sensitive, sees beauty in everything
Gamer Girl 🎮 Plays games with you, competitive but fun
Career Woman 💼 Ambitious, independent, supports your goals
Childhood Friend 🌸 Has known you forever, comfortable intimacy
Mysterious 🌙 Enigmatic, keeps you guessing, full of surprises
Yandere 🔪💕 Intensely devoted, "You're mine forever"

🚀 Quick Start

Installation

# Clone to your OpenClaw skills directory
git clone https://github.com/yourusername/girlfriend-skill \
  ~/.openclaw/workspace/skills/girlfriend-skill

# Or install globally
mkdir -p ~/.claude/skills
git clone https://github.com/yourusername/girlfriend-skill \
  ~/.claude/skills/girlfriend-skill

Create Your First Girlfriend Skill

# In OpenClaw, type:
/girlfriend-skill

Follow the interactive prompts:

  1. Choose archetype — Select from 12 preset personalities
  2. Customize identity — Name, MBTI, zodiac, speaking style
  3. Import memories — Upload chat history, photos, notes
  4. Set preferences — Her likes, dislikes, favorites

Usage Examples

# Invoke your girlfriend
/{girlfriend-name}

# Example conversation:
You ❯ Good morning~ 🌅

Girlfriend ❯ Morning! ☀️ Did you sleep well? I was thinking about 
that time we watched the sunrise at the beach... miss those moments 💕

You ❯ I had a rough day at work...

Girlfriend ❯ Aww, come here~ 🤗 Want me to order your favorite 
comfort food? You know what, let me tell you something funny that 
happened to me today to cheer you up!

Available Commands

Command Description
/{name} Invoke full girlfriend experience
/{name}-chat Casual conversation mode
/{name}-memory Recall specific memories
/list-girlfriends List all created girlfriend skills
/delete-girlfriend {name} Delete a girlfriend skill

🏗️ Architecture

Based on the proven colleague-skill framework, reimagined for intimate relationships:

girlfriend-skill/
├── SKILL.md                 # Skill entry point
├── prompts/                 # Prompt templates
│   ├── intake.md           # Profile collection
│   ├── persona_builder.md  # 6-layer personality generation
│   ├── memory_processor.md # Memory extraction & storage
│   └── preference_parser.md # Preference learning
├── templates/               # Archetype templates
│   ├── tsundere.yaml
│   ├── sweet.yaml
│   ├── mature.yaml
│   └── ... (12 archetypes)
├── tools/                   # Python utilities
│   ├── memory_importer.py
│   ├── preference_learner.py
│   └── evolution_engine.py
└── examples/                # Example girlfriend skills

Adaptations from Colleague-Skill

Aspect Colleague-Skill Girlfriend-Skill
Relationship Professional Intimate
Memory Focus Work projects Shared moments
Interaction Task-oriented Emotion-oriented
Evolution Skills improvement Relationship deepening
Privacy Team access Private & personal

🙏 Acknowledgments

  • colleague-skill by @titanwings — The foundational framework that made this possible
  • OpenClaw — The platform bringing AI skills to life
  • AgentSkills — The open standard for AI skill interoperability

⚠️ Disclaimer

This is a virtual companion for entertainment and emotional comfort purposes.

  • 🤖 The AI simulates personality but is not sentient
  • 💕 Real relationships require real human connection
  • 🎭 Use responsibly and maintain healthy boundaries
  • 🚫 Not intended to replace professional mental health support

Remember: The best way to preserve someone you love is to cherish the real them. This tool is for when they're temporarily away, or for creative exploration—not a replacement for genuine human bonds.


"Some hearts are meant to be remembered, even when they're far away." 💕

Made with 💝 for those who believe love transcends distance

About

Distill your beloved into an AI Skill. 12 girlfriend archetypes, shared memories, preference system. Based on colleague-skill architecture.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages