books-stats

name	books-stats
description	Show reading statistics from a Calibre library or Goodreads export, including pace, pages, ratings, authors, series, and TBR. Use when asked for reading statistics or habits.
user-invocable	true

Show reading statistics

Read ../books-library/SKILL.md first to choose the authoritative backend, then read ../books-library/references/statistics.md.

Calculate reading velocity for the current year and the last 30 and 90 days, monthly pace, total and average pages, longest and shortest books, personal and source-rating distributions, most-read authors, series versus standalone counts, and TBR size, pages, ratings, age, and recent additions. Use the selected backend's date, rating, read, archive, and TBR fields rather than assuming Calibre and Goodreads schemas are interchangeable.

Return a structured report with readable totals, rounded averages, a monthly breakdown, and a few evidence-based insights. Skip records missing required values, report how many were skipped, and do not compare the two backends unless the user explicitly asks and they represent the same library.