timeline-report

Generate chronological narrative reports from claude-mem project timelines.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/4asaanAI/Claude-patches --skill timeline-report
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: timeline-report
Source: https://github.com/4asaanAI/Claude-patches/tree/main/framework-foundry/Claude%20Plugins/claude-mem-main/plugin/skills/timeline-report
Command: npx skills add https://github.com/4asaanAI/Claude-patches --skill timeline-report

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill produces a comprehensive, chronological narrative of a project's entire development history by ingesting claude-mem timeline data and synthesizing events, architectural changes, debugging sagas, and token economics into a single report.

Core Features & Use Cases

  • Full-timeline ingestion: Fetches the complete claude-mem timeline for a specified project and estimates token cost before analysis.
  • Chronological narrative analysis: Produces a long-form "Journey Into [Project]" report covering genesis, architecture evolution, breakthroughs, work patterns, technical debt, and lessons learned.
  • Quantitative token economics: Queries the claude-mem SQLite DB to compute discovery token totals, session context ROI, monthly breakdowns, and top-value observations.
  • Operational safeguards: Detects git worktrees, prompts for user confirmation when timelines are large, and provides error messages for common failure modes.

Quick Start

Use the timeline-report skill to generate a "Journey Into [PROJECT]" narrative by fetching the project's claude-mem timeline and running the analysis agent.

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 a claude-mem timeline?▼

To generate a project history report, this Skill fetches the complete claude-mem timeline and synthesizes events, architectural changes, and debugging sagas into a chronological narrative analysis.

Can I analyze token economics and context ROI for my development sessions?▼

You can analyze token economics by querying the claude-mem SQLite DB, which computes discovery token totals, session context ROI, monthly breakdowns, and top-value observations for the project.

Do I need a running claude-mem worker to trace architectural evolution?▼

Tracing architectural evolution requires access to a running claude-mem worker on localhost:37777, and optionally the claude-mem SQLite DB for quantitative token economics queries.

What happens if my development timeline is too large for analysis?▼

When timelines are large, the Skill estimates token cost before analysis and prompts for user confirmation, while detecting git worktrees and providing error messages for common failure modes.

What is a development timeline narrative and what does it cover?▼

A development timeline narrative is a long-form report covering project genesis, architecture evolution, breakthroughs, work patterns, technical debt, and lessons learned synthesized from claude-mem timeline data.