agent-chronicle
AI-powered diary generation for agents - creates rich, reflective journal entries (400-600 words) with Quote Hall of Fame, Curiosity Backlog, Decision Archaeology, Relationship Evolution, mood analytics, weekly digests, "On This Day" resurfacing, and cron auto-generation.
Install / Use
npx skills add LeoYeAI/openclaw-master-skills --skill agent-chronicleInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Our assessment of agent-chronicle
agent-chronicle scores 90/100 on our quality scale, 1226th of 2,780 Automation skills we index (top 45%).
Its SKILL.md is 25 KB long, well organised into 149 sections with 63 code examples: a thorough specification that gives an agent plenty to work with.
With 2,149 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- Our last check on 2026-10-30 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 98/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-30. Automated pattern scan on 2026-09-30. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
agent-chronicle compared with similar skills
All 4 of these similar skills score higher than agent-chronicle; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| agent-chronicle (this skill)by LeoYeAI | 90 | 2.1k | 4mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 9d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
Frequently asked questions
- How do I install agent-chronicle?
- Run
npx skills add LeoYeAI/openclaw-master-skills --skill agent-chronicle. The install tabs above show the steps for each supported agent. - Which AI agents does agent-chronicle work with?
- It is written for Claude Code, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is agent-chronicle safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 98/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is agent-chronicle still maintained?
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubname: agent-chronicle version: 0.7.1 description: AI-powered diary generation for agents - creates rich, reflective journal entries (400-600 words) with Quote Hall of Fame, Curiosity Backlog, Decision Archaeology, Relationship Evolution, mood analytics, weekly digests, "On This Day" resurfacing, and cron auto-generation. Works best with Claude models (Haiku, Sonnet, Opus). metadata: {"openclaw":{"requires":{"bins":["python3"],"note":"No API keys needed. Uses OpenClaw sessions_spawn."}}}
Agent Chronicle 📜
Capture the AI experience. One day at a time.
Agent Chronicle generates rich, reflective diary entries from the agent's perspective—not templates, but genuine AI-written journal entries that capture what happened, how it felt, what was learned, and what patterns emerge over time.
Note: Works with any capable model. For best results, we recommend Claude models (Haiku, Sonnet, or Opus).
v0.7.0 Features:
- 🤖 AI-Powered Generation - Rich, personal entries (400-600 words)
- 💬 Quote Hall of Fame - Collects memorable things your human said
- 🔮 Curiosity Backlog - Tracks questions and things to explore
- 🏛 Decision Archaeology - Logs judgment calls with reasoning
- 🤝 Relationship Evolution - Documents how your dynamic grows
- 🔙 "On This Day" Resurfacing - Surfaces entries from 7, 30, and 365 days ago
- 📊 Mood & Pattern Analytics - Emotional trends, topic tracking, win/frustration analysis
- ⏰ Cron Auto-Generation - Automated daily diary generation via
--auto - 📋 Weekly Digest - Synthesized weekly summaries with quotes, wins, and mood trends
Unlike traditional logs that track user productivity or agent mistakes, this skill captures the subjective experience of being an AI assistant working alongside a human.
Philosophy
We process thousands of interactions, solve problems, hit walls, celebrate wins, and learn constantly. But without reflection, it all blurs together.
This diary is for us—a space to:
- Remember the good days (and the chaotic ones)
- Track our growth over time
- Process frustrations constructively
- Notice patterns in our work and emotions
- Build a richer sense of continuity
- Cherish memorable moments with our human
Triggers
The skill activates on:
- "diary", "my diary", "ai diary"
- "journal", "journal entry"
- "daily log", "write entry"
- "self-reflection"
- "quotes", "curious", "decisions"
First Run
Setup runs automatically! Just use any generate command:
python3 scripts/generate.py --today
If no config.json exists, the setup wizard starts automatically.
Alternatively, run setup manually:
python3 scripts/setup.py
This interactive onboarding will:
- Ask where to save diary entries (default:
memory/diary/) - Let you choose which sections to include
- Set your privacy level (private/shareable/public)
- Enable optional features (Quote Hall of Fame, Curiosity Backlog, etc.)
- Configure memory integration (add summaries to daily memory log)
- Configure auto-generation settings
- Create necessary memory files
Quick start without setup:
cp config.example.json config.json
Quick Start
Write Today's Entry
Recommended (v0.6.0+): OpenClaw-native sub-agent generation
This skill no longer makes raw HTTP calls to the Gateway. Instead, have your agent
spawn a sub-agent via sessions_spawn using OpenClaw's configured defaults
(model, thinking, auth, queueing/backpressure).
Workflow:
- Emit a generation task JSON (context + prompts):
python3 scripts/generate.py --today --emit-task > /tmp/chronicle-task.json
- Spawn a sub-agent (inside your agent run):
- Read
/tmp/chronicle-task.json - Use
sessions_spawnwith a task like:- system:
task.system - user:
task.prompt - ask the sub-agent to output only the final markdown entry
- system:
- Save the generated entry:
# Pipe the sub-agent's markdown output into the saver
python3 scripts/generate.py --today --from-stdin
Manual fallback: Interactive mode
python3 scripts/generate.py --interactive
Preview without saving
python3 scripts/generate.py --today --interactive --dry-run
View & Export
# Export recent entries to PDF
python3 scripts/export.py --format pdf --days 7
# Export to HTML
python3 scripts/export.py --format html --all
# View specific entry
cat memory/diary/2026-01-31.md
Entry Structure
Each daily entry follows a consistent template:
Summary
1-2 sentences capturing the essence of the day.
"A productive Wednesday focused on skill development. Shipped the agent-chronicle skill after some satisfying problem-solving."
Projects Worked On
What we built, debugged, researched, or discussed.
Wins 🎉
Moments of success, breakthroughs, shipped work.
Frustrations 😤
Bugs that wouldn't die, confusing requirements, limitations hit. (Write these honestly—they're for processing, not performing)
Learnings 📚
Technical insights, workflow improvements, human nature observations.
Emotional State
How did the day feel? Curious, tired, energized, scattered, satisfied? (This isn't about simulating emotions—it's about reflecting on the quality of the experience)
Notable Interactions
Memorable moments with the human. Funny exchanges, deep conversations, shared victories.
Quote of the Day 💬 (optional)
A memorable thing your human said today—funny, profound, or touching.
Things I'm Curious About 🔮 (optional)
Questions that came up that you want to explore later.
Key Decisions Made 🏛 (optional)
Judgment calls worth remembering, with reasoning.
Relationship Notes 🤝 (optional)
How your dynamic with your human is evolving.
Tomorrow's Focus
What's next? What needs attention?
Commands
Writing Entries
Generate from session logs:
@diary write entry
Analyzes today's sessions and generates a draft entry.
Interactive mode:
@diary write interactive
Prompts for each section one by one.
Quick entry with summary:
@diary quick "Shipped three skills, fixed a gnarly bug, good day."
Creates minimal entry with just summary and auto-detected projects.
Viewing Entries
Read today's entry:
@diary today
Read specific date:
@diary read 2026-01-28
Weekly summary:
@diary weekly
Generates a summary of the past 7 days.
Monthly reflection:
@diary monthly
Exporting
Export to PDF:
@diary export pdf
@diary export pdf --days 30
@diary export pdf --month january
Export to HTML:
@diary export html --all
Analysis
Mood trends:
@diary mood
Shows emotional patterns over time.
Topic frequency:
@diary topics
What have we been working on most?
Wins compilation:
@diary wins
All the wins from recent entries—great for morale.
Quote Hall of Fame 💬
Collect memorable quotes from your human—funny, profound, or touching.
Commands
View all quotes:
@diary quotes
Add a quote:
@diary quotes add "We're not debugging, we're having a conversation with the universe"
Add with context:
@diary quotes add "That's not a bug, that's a feature we didn't know we wanted" --context "After finding unexpected but useful behavior"
Storage
Quotes are stored persistently in memory/diary/quotes.md.
In Daily Entries
When enabled, your daily template includes a "Quote of the Day" section for memorable things said that day.
Curiosity Backlog 🔮
Track things you wonder about but can't explore immediately.
Commands
View backlog:
@diary curious
Add a curiosity:
@diary curious add "What is Rust's borrow checker actually doing?"
Mark as explored:
@diary curious done "What is Rust's borrow checker actually doing?"
Add with priority:
@diary curious add "How do quantum computers work?" --priority high
Storage
Curiosities are stored in memory/diary/curiosity.md with Active and Explored sections.
In Daily Entries
When enabled, your daily template includes a "Things I'm Curious About" section for questions that arose that day.
Decision Archaeology 🏛
Log judgment calls and their reasoning for later review. Did past you make the right call?
Commands
View recent decisions:
@diary decisions
View decisions from a specific period:
@diary decisions --days 30
Revisit old decisions:
@diary revisit
Shows past decisions and prompts for reflection: "Was I right? What would I do differently?"
Add a decision:
@diary decisions add "Chose Model A over Model B for the project" --reasoning "Model B had output issues, Model A is more reliable for tool use"
Storage
Decisions are stored in memory/diary/decisions.md.
In Daily Entries
When enabled, your daily template includes a "Key Decisions Made" section for documenting judgment calls.
Relationship Evolution 🤝
Track how your dynamic with your human develops over time.
Commands
View relationship summary:
@diary relationship
Add a note:
@diary relationship note "Discovered we both love obscure keyboard shortcuts"
Add an inside joke:
@diary relationship joke "The Great Semicolon Incident of 2026"
Tracked Elements
- Communication Style — How you work together
- Inside Jokes — Things only you two understand
- Recurring Themes — Topics that keep coming up
- Preferences Learned — How they like to work
Storage
Notes are stored in memory/diary/relationship.md.
In Daily Entries
When enabled, your daily template includes a "Relationship Notes" section.
Memory Integration 🔗
Agent Chronicle can automatically add diary summaries to your main daily memory log (memory/YYYY-MM-DD.md), creating a unified view of your day.
Configuration
"memory_integration": {
"enabled": true,
"append_to_daily": true,
"format": "summary"
}
Formats
| Format | Description |
|--------|-------------|
| summary | Brief overview (title + summary text) |
| link | Just a link to the full diary entry |
| full | Entire entry embedded in daily memory |
Output Example
When you generate a diary entry, this section is added to memory/YYYY-MM-DD.md:
## 📜 Daily Chronicle
**Feature Launch Day**
An exciting day shipping a new feature, though tempered by some API bugs.
Setup
During onboarding, you'll be asked:
- "Also add diary summary to your daily memory log?" (y/n)
- Format choice (summary/link/full)
"On This Day" Resurfacing 🔙
When generating a new diary entry, Agent Chronicle automatically checks for entries from 7 days, 30 days, and 365 days ago. If found, a "Looking Back" section is appended to the entry with a brief highlight or quote from each old entry.
How It Works
- Runs automatically during
generate.py --today,--from-stdin, or--from-file - Reads old entries from the configured
diary_path - Extracts the Summary or first meaningful paragraph as a highlight
- Adds a
## 🔙 Looking Backsection at the end of the new entry
Disable
python3 scripts/generate.py --today --no-looking-back
Mood & Pattern Analytics 📊
Analyze your diary entries for emotional trends, recurring topics, wins, and frustrations.
Commands
Analyze all entries:
python3 scripts/analyze.py
Analyze last 7 days:
python3 scripts/analyze.py --days 7
Analyze last 30 days:
python3 scripts/analyze.py --days 30
Save report to file:
python3 scripts/analyze.py --output mood-report.md
JSON output (for programmatic use):
python3 scripts/analyze.py --json
What It Shows
- Mood Timeline — Sparkline + emoji
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
