Agent skill · writing content · thedotmack
timeline-report
Generate a "Journey Into [Project]" narrative report analyzing a project's entire development history from claude-mem's timeline. Use when asked for a timeline report, project history analysis, development journey, or full project report.
Why this skill is useful
Adds a specific workflow for generating detailed project history reports using claude-mem's API, which the AI wouldn't reliably generate on its own.
What it needs
Requires curl, git installed locally. About 7k tokens when loaded. Last updated 2026-08-05. 89,894 stars on the source repository.
What this skill does
Timeline Report Generate a comprehensive narrative analysis of a project's entire development history using claude-mem's persistent memory timeline. When to Use Use when users ask for: "Write a timeline report" "Journey into [project]" "Analyze my project history" "Full project report" "Summarize the entire development history" "What's the story of this project?" Prerequisites The claude-mem worker must be running. The project must have claude-mem observations recorded. Resolve the worker port (do this once at the start and reuse $WORKERPORT in every curl call below): This honors CLAUDEMEMWORKERPORT env, then ~/.claude-mem/settings.json, then falls back to the per-UID default 37700 + (uid % 100) — matching how the worker itself picks its port. Required for multi-account setups (#2101) and any user who has overridden the default port (#2103). Workflow Step 1: Determine the Project Name Ask the user which project to analyze if not obvious from context. The project name is typically the directory name of the project (e.g., "tokyo", "my-app"). If the user says "this project", use the current working directory's basename. Worktree Detection: Before using the directory basename, check if the current directory is a git worktree. In a worktree, the data source is the parent project, not the worktree directory itself. Run: If a worktree is detected, use $parentproject (the basename of the parent repo) as the project name for all API calls. Inform the user: "Detected git worktree. Using parent project '[name]' as the data source." Step 2: Fetch the Full Timeline Use Bash to fetch the complete timeline from the claude-mem worker API: This returns the entire compressed timeline -- every observation, session boundary, and summary across the project's full history. The response is pre-formatted markdown optimized for LLM consumption. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills thedotmack/timeline-report