# Send Chat History Analyzer to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "chat-history-analyzer",
    "name": "Chat History Analyzer",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/RuneweaverStudios/chat-history-analyzer",
    "canonicalUrl": "https://clawhub.ai/RuneweaverStudios/chat-history-analyzer",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/chat-history-analyzer",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=chat-history-analyzer",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "_meta.json",
      "scripts/analyze_logs.py",
      "scripts/chat_history_analyzer.py",
      "scripts/combined_analysis.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/chat-history-analyzer"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/chat-history-analyzer",
    "downloadUrl": "https://openagent3.xyz/downloads/chat-history-analyzer",
    "agentUrl": "https://openagent3.xyz/skills/chat-history-analyzer/agent",
    "manifestUrl": "https://openagent3.xyz/skills/chat-history-analyzer/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/chat-history-analyzer/agent.md"
  }
}
```
## Documentation

### Description

Extracts and analyzes Cursor IDE chat history to identify key discoveries, obstacles, and solutions, saving findings to the journal.

### Chat History Analyzer | OpenClaw Skill

Extracts chat history from Cursor IDE's local SQLite databases, analyzes the last hour of conversations for key discoveries, obstacles, and solutions, and saves structured findings to the OpenClaw journal directory.

### Usage

As a scheduled cron job to continuously track insights from chat history
Manually to analyze recent chat activity
To identify recurring patterns, problems, or solutions in your workflow

# Combined log and chat history analysis (for cron jobs)
python3 /Users/ghost/.openclaw/workspace/skills/chat-history-analyzer/scripts/analyze_logs.py

# Analyze last hour of chat history only
python3 /Users/ghost/.openclaw/workspace/skills/chat-history-analyzer/scripts/chat_history_analyzer.py

# Analyze last 2 hours
python3 /Users/ghost/.openclaw/workspace/skills/chat-history-analyzer/scripts/chat_history_analyzer.py --hours 2

# Output JSON format
python3 /Users/ghost/.openclaw/workspace/skills/chat-history-analyzer/scripts/analyze_logs.py --json

### What this skill does

Extracts chat history from Cursor's SQLite databases (global and workspace-specific)
Analyzes the last hour of messages for patterns indicating discoveries, obstacles, and solutions
Saves structured findings to /Users/ghost/.openclaw/journal/ as markdown files
Runs automatically via cron job every hour

### Integration as a Cron Job

This skill is designed to run hourly via OpenClaw cron. The analyze_logs.py script combines both log analysis and chat history analysis.

Example Cron Job Configuration:

{
  "payload": {
    "kind": "agentTurn",
    "message": "Run analyze_logs.py script to analyze the last hour of logs and Cursor chat history, saving findings to journal.",
    "model": "openrouter/google/gemini-2.5-flash",
    "thinking": "low",
    "timeoutSeconds": 180
  },
  "schedule": {
    "kind": "cron",
    "cron": "0 * * * *"
  },
  "delivery": {
    "mode": "announce"
  },
  "sessionTarget": "isolated",
  "name": "Chat History & Log Analysis"
}

Or run directly via shell script:

# Add to crontab (crontab -e)
# Run every hour at minute 0
0 * * * * /Users/ghost/.openclaw/workspace/skills/chat-history-analyzer/scripts/analyze_logs.py --json >> /Users/ghost/.openclaw/logs/analyze_logs.log 2>&1

### Output Format

Findings are saved to /Users/ghost/.openclaw/journal/chat_analysis_YYYY-MM-DD_HHMMSS.md with sections for:

Key Discoveries: Successful findings, realizations, and implementations
Obstacles Encountered: Errors, failures, and blockers
Solutions Found: Fixes, workarounds, and resolutions

### Requirements

Cursor IDE installed with chat history stored locally
SQLite3 available (usually pre-installed on macOS)
OpenClaw journal directory writable

### How it works

Connects to Cursor's SQLite databases at ~/Library/Application Support/Cursor/User/globalStorage/state.vscdb and workspace-specific databases
Extracts messages from the last N hours (default: 1 hour)
Analyzes message content using pattern matching for discoveries, obstacles, and solutions
Saves structured markdown report to the journal directory
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: RuneweaverStudios
- Version: 1.0.5
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/chat-history-analyzer)
- [Send to Agent page](https://openagent3.xyz/skills/chat-history-analyzer/agent)
- [JSON manifest](https://openagent3.xyz/skills/chat-history-analyzer/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/chat-history-analyzer/agent.md)
- [Download page](https://openagent3.xyz/downloads/chat-history-analyzer)