๐ŸŽ Get the FREE AI Skills Starter Guide โ€” Subscribe โ†’
BytesAgainBytesAgain
๐Ÿฆ€ ClawHub

Session Log Analyzer

by @terrycarter1985

Analyze agent session logs and generate PDF reports with Notion sync

Versionv99.1.0
Downloads928
TERMINAL
clawhub install session-log-analyzer

๐Ÿ“– About This Skill


name: session-log-analyzer description: Analyze agent session logs and generate PDF reports with Notion sync version: 1.2.0 author: ClawdBot tags: [logs, analysis, pdf, notion] requires_bins: [python3] requires_env: [NOTION_API_KEY, NOTION_REPORTS_DB_ID] requires_config: [] changelog: - version: 1.2.0 date: 2026-05-07 changes: "ไฟฎๅคๆ—ฅๅฟ—ๅˆ†ๆžๆŠฅๅ‘Š็”Ÿๆˆๅ’ŒNotionๅŒๆญฅ้—ฎ้ข˜" - version: 1.1.0 date: 2026-05-07 changes: "ไฟฎๅคๆ—ฅๅฟ—ๅˆ†ๆžๆŠฅๅ‘Š็”Ÿๆˆๅ’ŒNotionๅŒๆญฅ้—ฎ้ข˜" - version: 1.0.0 date: 2026-04-01 changes: "Initial release"

Session Log Analyzer

Analyze agent session logs and generate PDF reports with optional Notion sync.

Features

  • Parse JSONL session logs and compute statistics
  • Generate PDF analysis reports with skill usage breakdown and error summaries
  • Sync generated reports to a Notion database
  • Usage

    Generate Report

    PYTHONPATH=./lib python3 scripts/analyze_logs.py
    

    Sync to Notion

    Set environment variables first:

    export NOTION_API_KEY="your-integration-token"
    export NOTION_REPORTS_DB_ID="your-database-id"
    PYTHONPATH=./lib python3 scripts/sync_to_notion.py
    

    Report Contents

  • Total sessions count
  • Skill invocation statistics (success/failure rates)
  • Duration totals
  • Per-skill usage breakdown
  • Recent errors listing
  • Configuration

    | Variable | Required | Description | |---|---|---| | NOTION_API_KEY | For sync | Notion integration token | | NOTION_REPORTS_DB_ID | For sync | Target Notion database ID |

    Notes

  • Input logs must be in JSONL format with event, session_id, skill_used, success, and duration fields
  • PDF output is saved to pdfs/session_analysis_report.pdf
  • Notion sync uploads the first 2000 characters of extracted report text
  • ๐Ÿ’ก Examples

    Generate Report

    PYTHONPATH=./lib python3 scripts/analyze_logs.py
    

    Sync to Notion

    Set environment variables first:

    export NOTION_API_KEY="your-integration-token"
    export NOTION_REPORTS_DB_ID="your-database-id"
    PYTHONPATH=./lib python3 scripts/sync_to_notion.py
    

    โš™๏ธ Configuration

    | Variable | Required | Description | |---|---|---| | NOTION_API_KEY | For sync | Notion integration token | | NOTION_REPORTS_DB_ID | For sync | Target Notion database ID |

    ๐Ÿ“‹ Tips & Best Practices

  • Input logs must be in JSONL format with event, session_id, skill_used, success, and duration fields
  • PDF output is saved to pdfs/session_analysis_report.pdf
  • Notion sync uploads the first 2000 characters of extracted report text