saudade

Distill chat history, photo EXIF metadata, and social exports into a personalized crush Skill.

13|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/aialok/saudade --skill saudade
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: saudade
Source: https://github.com/aialok/saudade/tree/main
Command: npx skills add https://github.com/aialok/saudade --skill saudade

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of turning scattered chat history, notes, and photo metadata into a coherent, usable conversational persona that stays grounded in what you actually shared.

Core Features & Use Cases

  • Crush Skill Generation: Creates a “crush” Skill with two working parts—Shared Memories and a Persona—organized under crushes/{slug}/ for Claude Code invocation.
  • Multi-source Import: Ingests iMessage/SMS/WhatsApp exports (including macOS chat.db reads), photo timelines from EXIF metadata, and social/text exports for relationship grounding.
  • Ongoing Evolution: Supports incremental appends and conversation correction via versioning, merging, and a correction log.

Quick Start

Use this skill by running /create-crush and providing a nickname and relationship snapshot, then point it at files under data/chats/ or paste your text when asked.

Frequently Asked Questions about saudade

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

FAQPage Schema
How do I turn chat history into a conversational persona in Claude Code?

You can turn chat history into a conversational persona by running the /create-crush command in Claude Code, which parses your text exports and photo metadata to generate a personalized Skill with Shared Memories and a Persona.

Can I build a relationship timeline from iMessage or WhatsApp chat logs?

Yes, you can build a relationship timeline from iMessage or WhatsApp chat logs by placing your exported files under data/chats/ or pasting the text directly, allowing the Skill to parse macOS chat.db reads and social exports.

What is the best way to create a photo timeline using EXIF metadata?

The best way to create an EXIF photo timeline is to import photo metadata alongside your chat history into the Skill, which uses tool-driven parsing to extract dates and locations to ground relationship memories chronologically.

How do I update a crush persona after adding new chat logs?

You update a crush persona by appending new chat logs to the existing Skill, which supports incremental evolution through versioning, merging, and a correction log to refine the Shared Memories and Persona files.

Do I need a specific folder structure to generate a relationship persona?

Yes, you need a root SKILL.md entry point and a data/chats/ directory for your exports, and the Skill will automatically create the required memories.md, persona.md, and meta.json files under the crushes/{slug}/ folder.

Can I fix incorrect memories in a generated crush persona?

Yes, you can fix incorrect memories by adding correction entries to the Skill, which maintains a correction log and applies versioning and merging to ensure the persona stays grounded in what you actually shared.