weekly-reflection

Summarize weekly diary and check-in files into conversational insights.

1|1|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/yuyuxinli/moodcoco --skill weekly-reflection-yuyuxinli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: weekly-reflection
Source: https://github.com/yuyuxinli/moodcoco/tree/main/ai-companion/skills/weekly-reflection
Command: npx skills add https://github.com/yuyuxinli/moodcoco --skill weekly-reflection-yuyuxinli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Help users see their week as a coherent whole by reading diary entries and check-ins, surfacing repeating emotional themes, frequent people/trigger mentions, and lightweight growth signals so insights are offered gently rather than as a report.

Core Features & Use Cases

  • Triggered by a Sunday 20:00 Heartbeat, but only runs when there is sufficient diary data and the user hasn't opted out.
  • Aggregates diary/YYYY/MM/YYYY-MM-DD.md and memory check-in data, performs semantic emotion grouping, repeated-theme detection (emotion/person/trigger), cross-week pattern matching, and lightweight growth-signal detection.
  • Produces conversational summaries by default and can output JSON for agent consumption or Canvas-ready HTML on supportive platforms; includes caching (weekly_cache), downgrade rules for repeated refusals, and clear safety fallbacks to pause if the user becomes distressed.
  • Real-world use: automatically send a friendly Sunday message highlighting a recurring worry and asking if the user wants to talk about this week's events.

Quick Start

Ask the agent to run a weekly reflection and present a brief conversational summary of this week's diary entries and check-ins.

Frequently Asked Questions about weekly-reflection

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

FAQPage Schema
How do I automatically summarize my weekly diary entries and check-ins?

To automatically summarize weekly diary entries and check-ins, this Skill reads local files and memory data to surface repeating emotional themes, frequent people mentions, and triggers. It triggers via a scheduled heartbeat but only runs when sufficient data exists.

How does semantic emotion grouping work for weekly mood-tracking reviews?

Semantic emotion grouping for weekly mood-tracking reviews works by aggregating local diary and check-in data, detecting repeated themes, and performing fuzzy cross-week pattern matching. This surfaces growth signals and recurring worries for conversational summaries.

Can I export weekly reflection results as JSON or HTML for Canvas presentation?

You can export weekly reflection results as JSON for agent consumption or Canvas-ready HTML for presentation. By default it produces conversational summaries, utilizing a weekly cache to store and manage these outputs.

What file format does the weekly review need for diary entries?

The weekly review requires diary entries saved as local markdown files following the diary/YYYY/MM/YYYY-MM-DD.md path structure, alongside memory check-in data, to perform cross-week matching and emotion analysis.

What happens if a user becomes distressed during an AI companion weekly check-in?

If a user becomes distressed during an AI companion weekly check-in, the Skill includes clear safety fallbacks to pause the interaction. It also applies downgrade rules for repeated refusals to ensure supportive conversations.