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.