gemini-history-analyzer

Extracts, categorizes, and analyzes Google Takeout exports of Gemini conversation history.

1.4k|216|Updated Oct 22, 2025
One-click install
npx skills add https://github.com/daymade/claude-code-skills --skill gemini-history-analyzer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gemini-history-analyzer
Source: https://github.com/daymade/claude-code-skills/tree/main/gemini-history-analyzer
Command: npx skills add https://github.com/daymade/claude-code-skills --skill gemini-history-analyzer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires unar.

What problem does it solve?

Google Takeout exports of Gemini activity arrive as messy ZIP archives with Unicode filenames, mixed media, and hundreds of transcripts that are impractical to review manually. This Skill turns that raw export into a structured, searchable analysis.

Core Features & Use Cases

  • Unicode-safe extraction and inventory: Uses unar to avoid macOS unzip corrupting Chinese filenames, then builds a full file-type and size inventory.
  • Topic classification and conversation typing: Distinguishes meeting transcripts from prompt-response chats, classifies topics, and extracts key findings, decisions, and quotes per file.
  • Domain keyword search with context verification: Greps for finance/legal/etc. terms, then reads surrounding context to eliminate false positives before reporting.
  • Structured reporting and memory generation: Produces a Markdown analysis report with PII flagging, and can optionally write user-profile or project memory files.
  • Use Case: Drag a Google Takeout ZIP into your project and ask what you discussed with Gemini about investing; the Skill extracts the archive, searches with context verification, and delivers a categorized report.

Quick Start

Analyze my Gemini Takeout export at ~/Downloads/takeout.zip and tell me what topics I discussed, with a focus on any finance-related conversations.

Frequently Asked Questions about gemini-history-analyzer

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

FAQPage Schema
How do I analyze my Gemini conversation history from Google Takeout?

Request a Google Takeout export of Gemini Apps activity, then point the Skill at the ZIP file. It extracts the archive, inventories all transcripts, classifies topics, and generates a structured Markdown report with key findings.

How to extract Google Takeout ZIP files with Chinese filenames on macOS?

Use unar instead of the built-in unzip command, which silently corrupts Chinese and Unicode filenames. Install it with brew install unar, then run unar -o <output-dir> <zip-path> to extract everything correctly.

Why does keyword search on Gemini transcripts return so many false positives?

Words like stock, option, fund, and portfolio appear constantly in software development contexts with different meanings. The Skill greps for keywords first, then reads surrounding context for every match to classify hits as definite, false positive, or ambiguous.

Can Gemini Takeout analysis detect PII or sensitive content?

Yes, the analysis flags files containing PII such as resumes, background checks, or contact lists with a risk level. The actual PII content is never copied into reports or memory files, only summarized references.

What are the limitations of analyzing large Gemini history exports?

Exports with 100+ files require parallel batch processing since sequential reading exhausts context. Large transcripts are triaged by reading the first and last 10 percent unless keyword hits or topic relevance justify a full read.