Agent skill · AI & Agents

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.

Alex Newman88,857★ · +719/wk · 1 repos on radarProfile →
claude-codeApache-2.0
Install
npx skills add thedotmack/claude-mem --skill timeline-report --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 1
SKILL.md size: 12 KB
Bundled scripts: none
Path: plugin/skills/timeline-report/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 89,517 · +660 this week
Language: JavaScript
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# 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 `$WORKER_PORT` in every curl call below): ```bash WORKER_PORT="${CLAUDE_MEM_WORKER_PORT:-$(node -e "const fs=require('fs'),p=require('path'),os=require('os');const uid=(typeof process.getuid==='function'?process.getuid():77);const fallback=String(37700+(uid%100));try{const s=JSON.parse(fs.readFileSync(p.join(os.homedir(),'.claude-mem','settings.json'),'utf-8'));process.stdout.write(String(s.CLAUDE_MEM_WORKER_PORT||fallback));}catch{process.stdout.write(fallback);}" 2>/dev/null)}" ``` This honors `CLAUDE_MEM_WORKER_PORT` env, then `~/.claude-mem/settings.json`, then falls back to the per-UID default `37700 + (uid % 100)` — matching h

What's inside
Steps it walks through
  1. When to Use
  2. Prerequisites
  3. Workflow
  4. Step 1: Determine the Project Name
  5. Step 2: Fetch the Full Timeline
  6. Step 3: Estimate Token Count
  7. Step 4: Analyze with a Subagent
  8. Step 5: Save the Report
  9. Step 6: Report Completion
  10. Error Handling
  11. Example
Commands it runs
if [ "$git_dir" != "$git_common_dir" ]; then
echo "Worktree detected. Parent project: $parent_project"
else
fi
echo "$parent_project"
curl -s "http://localhost:${WORKER_PORT}/api/context/inject?project=PROJECT_NAME&full=true"
More from claude-mem
All skills →
About this skill
What does the timeline-report skill do?

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.

How do I install it?

Run `npx skills add thedotmack/claude-mem --skill timeline-report --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From thedotmack/claude-mem, a repository with 89,517 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going