insight-report

Generate HTML insight reports from local Codex session data.

8|4|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/jscraik/Agent-Skills --skill insight-report
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: insight-report
Source: https://github.com/jscraik/Agent-Skills/tree/main/utilities/insight-report
Command: npx skills add https://github.com/jscraik/Agent-Skills --skill insight-report

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the need for detailed, evidence-based analysis of local Codex session data, transforming raw logs into understandable HTML reports and preventing anecdotal guesswork.

Core Features & Use Cases

  • Generate High-Fidelity Reports: Creates durable HTML artifacts from session history.
  • Metric-Driven Analysis: Focuses on reproducible metrics and confidence limits.
  • Use Case: When a user requests a usage report for the past month, this skill will process the session data, identify key patterns and blockers, and present them in a clear HTML format.

Quick Start

Generate a 7-day usage report with top workflows and blockers.

Frequently Asked Questions about insight-report

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

FAQPage Schema
How do I generate an HTML report from local Codex session data?▼

To generate an HTML report from local Codex session data, you specify a time-bounded scope like a 7-day period. The skill processes your session history to identify usage patterns, metrics, and blockers, producing a durable, evidence-backed HTML artifact.

What is the best way to analyze Codex usage patterns without anecdotal guesswork?▼

The best way to analyze Codex usage without anecdotal guesswork is using metric-driven analysis on local session data. This approach transforms raw logs into reproducible metrics with confidence notes, ensuring your workflow retrospectives are evidence-based.

Can I use this to identify blockers in my Codex session history for a specific period?▼

Yes, you can identify blockers in your Codex session history by defining a user-specified scope or time-bounded retrospective. The analysis processes local session data to extract and highlight specific blockers within the generated HTML report.

What scope do I need to provide to analyze metrics from Codex sessions?▼

You need to provide a user-specified time scope, such as a 7-day or monthly usage period. Defining this scope allows the analysis to bound the local session data and accurately calculate reproducible metrics for the report.

Does generating these usage reports require any external dependencies?▼

Generating these usage reports does not require external dependencies. The skill operates directly on local Codex session data to produce high-fidelity HTML reports without needing additional external libraries or tools.