relation-keeper

What This Skill Does

The relation-keeper skill acts as your personal digital assistant for social relationship management. It is designed to help you maintain, remember, and receive timely reminders about the people in your life. By consolidating fragmented information into a structured database, the skill handles three core functions: maintaining individual portraits (including contact info, preferences, and birthdates), tracking future appointments or anniversaries, and archiving past shared experiences. Unlike standard calendar apps, it links events to specific people, enabling a rich, person-centric view of your social interactions.

Installation

To integrate this skill into your OpenClaw environment, use the command: clawhub install openclaw/skills/skills/yujintang/relation-keeper. Once installed, the postinstall script will automatically configure the internal cron jobs required to scan for events and trigger reminders. If you encounter any issues during automatic setup, you can manually trigger the cron configuration by navigating to the skill directory and executing npm run install:cron.

Use Cases

• Comprehensive CRM for Personal Life: Track everything from professional contacts to close friends by logging details like phone numbers, addresses, and key facts such as personal preferences or job titles.
• Smart Reminder System: Automatically manage birthday reminders and meeting alerts without manual setup. The system scans your database every 15 minutes to ensure you are notified 7 days, 3 days, or on the day of an anniversary/birthday, and 2 hours before or at the start of a scheduled appointment.
• Relationship Memory Retrieval: Quickly query your history with specific individuals to recall previous conversations or shared activities, helping you build better rapport over time.

Example Prompts

1. "Record that I met with Sarah yesterday for dinner to discuss our upcoming startup project."
2. "What are some things I should remember about Zhang San?"
3. "Do I have any upcoming meetings or important dates related to my family this week?"

Tips & Limitations

• Data Consistency: The system automatically handles duplicate facts by keeping the most recent entry. For best results, use clear, descriptive language when feeding information to the agent.
• Automatic Scheduling: You do not need to create individual reminders for every event. Simply add the event to your log, and the background scanner will handle the notification logic.
• Dependencies: This skill relies on local file storage. Ensure your environment allows for read and write permissions in the specified $RELATION_KEEPER_DATA directory or the default data/ folder within the skill directory.
• Limitations: The skill is primarily designed for structured tracking. Extremely complex, multi-day recurring project tasks are better suited for specialized project management tools.