Insight Report

Generate local Codex usage reports. Use when users ask for usage analytics, weekly insights, session summaries, telemetry patterns, or prompting help.

9 stars 4 forksAI, LLMs & Agents

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add jscraik/Agent-Skills --skill insight-report
Manual install
git clone --depth 1 https://github.com/jscraik/Agent-Skills.git /tmp/Agent-Skills
mkdir -p ~/.claude/skills
cp -r /tmp/Agent-Skills/Skills/agent-ops/insight-report ~/.claude/skills/insight-report

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Insight Report

Generate a local Codex usage report where Codex writes the narrative insight and the runner collects evidence, validates JSON, and renders HTML.
Keep each run scoped to the requested window and the 2-3 strongest evidence-backed patterns.

## Philosophy

Evidence beats intuition. Codex may write the insight, but the report must stay grounded in bounded local artifacts.

## When To Use

- "Show me my Codex analytics"
- "Generate my weekly insights report"
- "What am I doing well with Codex?"
- "Where am I getting stuck?"
- "Help me prompt better when I do not know the technical terms"

## Required inputs

- Session evidence from `~/.agents/session-collector` when available.
- Raw `~/.codex/sessions/` as fallback evidence.
- Optional telemetry from `~/.agents/otel-collector/`.
- Time window, usually `--days N`.

## Workflow

Start with 2-3 focused surfaces: session themes, friction points, and next-step prompting improvements. Widen only when the user asks for a deeper analytics pass.

Use the compatibility runner:

```bash
python3 Skills/agent-ops/insight-report/scripts/run_insight_report.py --days 7
```

Use `--prepare-only --no-open` when this live Codex session should write `insights.generated.json` manually. Use `--render-only --no-open` after repairing or regenerating that JSON.

## Deliverables

Expected artifacts live under `${INSIGHT_REPORT_USAGE_DIR:-$HOME/.codex/usage-data}/`:

- `insight-evidence.json`
- `INSIGHT_PROMPT.md`
Read the full skill on GitHub

Details

Skill name
insight-report
Path
Skills/agent-ops/insight-report/SKILL.md
License
Apache-2.0
Repo updated
16 November 2026

FAQ

What does the Insight Report skill do?

Generate local Codex usage reports. Use when users ask for usage analytics, weekly insights, session summaries, telemetry patterns, or prompting help.

How do I install the Insight Report skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add jscraik/Agent-Skills --skill insight-report. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Insight Report popular?

It lives in jscraik/Agent-Skills, which has 9 GitHub stars and 4 forks.

Related skills

1password

9

jscraik/Agent-Skills

Plan, diagnose, and validate 1Password CLI workflows. Use when tasks need op CLI sign-in, secret references, op run, op inject, item reads, env injection, or service-account secret access.

Security

Agentation

9

jscraik/Agent-Skills

Audit, validate, and troubleshoot Agentation integrations in frontend apps. Use when annotations, MCP registration, endpoint sync, webhook delivery, or watch mode readiness are failing.

AI, LLMs & Agents

Agents Md

9

jscraik/Agent-Skills

Use when reviewing, creating, shrinking, or refactoring AGENTS.md and directly linked instruction guidance for stale or conflicting rules against current model documentation, scoped routing, deduplication, or progressive disclosure.

AI, LLMs & Agents

Internal Double Crux

5

EquiStamp/CFAR-Claude-Skills

CFAR rationality technique for resolving internal conflicts by facilitating dialogue between competing motivations or "sub-agents" within the mind. Use when the user: (1) feels torn between two options or motivations, (2) experiences "should" vs "want" conflicts, (3) can't motivate themselves despite believing something is right, (4) wants to understand procrastination or self-sabotage, (5) has internal resistance they can't explain, or (6) wants to practice parts-work for better self-understanding. Related to IFS. Triggers: "internal double crux", "IDC", "torn between", "part of me wants", "I

AI, LLMs & Agents

Improve Agent Native

9

jscraik/Agent-Skills

Check if a repository or agent-facing product surface is ready for AI coding agents. Use when you need to audit repo agent compatibility, review AGENTS.md, find missing test/build commands, evaluate docs quality, assess tool/action parity, or produce a file-evidence scorecard with specific fixes.

AI, LLMs & Agents

LLM Wiki

9

jscraik/Agent-Skills

Create or update an Obsidian-friendly local markdown knowledge base. Use when the user wants LLM-maintained notes, wikilinks/backlinks, frontmatter, citations, local attachments, vault cleanup, or reusable research synthesis.

AI, LLMs & Agents

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.