sync-report

Generates diagnostic HTML reports from utility-bill-manager sync logs.

Updated Jan 27, 2026
One-click install
npx skills add https://github.com/mccode415/agent --skill sync-report
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-report
Source: https://github.com/mccode415/agent/tree/main/skills/sync-report
Command: npx skills add https://github.com/mccode415/agent --skill sync-report

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps diagnose and understand failures in the utility-bill-manager synchronization process by generating detailed, visual HTML reports from log files.

Core Features & Use Cases

  • Log Analysis: Parses sync logs to identify specific error categories like VectorDB issues, LLM failures, selector problems, and PDF download errors.
  • Report Generation: Creates interactive HTML reports that visualize the sync process, highlight root causes, and provide recommendations.
  • Use Case: When a sync fails and no bills are downloaded, use this Skill to analyze the sync.log file and get a clear report showing exactly where the process broke down and why.

Quick Start

Generate a diagnostic report for the log file located at /path/to/sync.log.

Frequently Asked Questions about sync-report

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

FAQPage Schema
How do I debug sync failures from utility-bill-manager logs?

Debug sync failures by generating diagnostic HTML reports that parse utility-bill-manager logs to analyze errors, identify root causes, and visualize where the process broke down.

What specific errors are identified when analyzing sync logs?

Analyzing sync logs identifies specific error patterns related to VectorDB, LLM, selectors, PDF downloads, and navigation failures to pinpoint exact breakdowns in the sync process.

How do I create an HTML report from a sync.log file?

Create an HTML report by providing the path to your sync.log file, which the script parses to generate an interactive visual report in a temporary directory for debugging.

Can I use this to troubleshoot PDF download and navigation failures?

Yes, you can use this to troubleshoot PDF download and navigation failures, as the log analysis specifically targets these error categories alongside VectorDB and LLM issues.

What is the best way to visualize navigator behavior during a failed sync?

The best way to visualize navigator behavior is by generating the HTML report, which highlights the sync process steps, shows root causes, and provides recommendations for the failed sync.

Why does my utility-bill-manager sync fail to download any bills?

A sync may fail to download bills due to selector problems, PDF download errors, or navigation failures, which this tool diagnoses by creating reports showing exactly where the process broke.