timeline-report

Generates a narrative report analyzing a project's full development history from claude-mem timeline data.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills --skill timeline-report-lgj-jonathan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: timeline-report
Source: https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills/tree/main/claude-mem/plugin/skills/timeline-report
Command: npx skills add https://github.com/LGJ-Jonathan/Jonathan_Global_Claude_Skills --skill timeline-report-lgj-jonathan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning months of raw development history into a coherent story is hard when observations are scattered across hundreds of sessions. This Skill fetches the complete claude-mem timeline for a project and produces a structured narrative report covering architecture evolution, breakthroughs, debugging sagas, and token economics. ## Core Features & Use Cases - Full Timeline Retrieval: Fetches every observation, session boundary, and summary from the claude-mem worker API, with automatic git worktree detection to resolve the correct parent project. - Subagent-Based Analysis: Delegates the timeline to an analysis agent that writes a 3,000-6,000 word "Journey Into [Project]" report with ten required sections including token economics and memory ROI. - SQLite Metrics Queries: Runs SQL against the claude-mem database to quantify discovery tokens, compression ratios, recall savings, and the highest-value observations. - Use Case: Ask for a journey report on a long-running project to understand how its architecture evolved, which bugs consumed the most effort, and what a new developer should learn from its history. ## Quick Start Ask the assistant to write a timeline report for your project, for example by saying "Write a journey report for the tokyo project" while the claude-mem worker is running.

Frequently Asked Questions about timeline-report

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

FAQPage Schema
How do I generate a project history report from claude-mem?

Ask for a timeline report or journey report for your project name. The Skill fetches the full timeline from the claude-mem worker API at localhost:37777, then deploys an analysis agent to write a narrative report saved as journey-into-PROJECT_NAME.md.

What does the timeline report analysis cover?

The report covers ten sections including project genesis, architectural evolution, key breakthroughs, work patterns, technical debt, debugging sagas, memory and continuity, token economics with ROI calculations, timeline statistics, and lessons learned, written as a 3,000-6,000 word narrative.

Does the timeline report work in a git worktree?

Yes, the Skill detects git worktrees by comparing git-dir and git-common-dir. When a worktree is detected, it resolves the parent repository name and uses that as the project name for all claude-mem API calls.

Why is the claude-mem timeline API returning empty results?

Empty results usually mean the worker is not running or the project name is wrong. Verify worker health with a search query against localhost:37777 and confirm the project name matches the directory basename recorded by claude-mem.

What are the token limits for analyzing large project timelines?

Small projects under 1,000 observations cost roughly 20-50K tokens, while large projects with 10,000-35,000 observations can reach 300-750K tokens. The Skill asks for confirmation before proceeding when the timeline exceeds 100K tokens.