Insight Report
Generate local Codex usage reports. Use when users ask for usage analytics, weekly insights, session summaries, telemetry patterns, or prompting help.
Install
npx skills add jscraik/Agent-Skills --skill insight-reportgit 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-reportPersonal 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`Details
- Skill name
insight-report- Repository
- jscraik/Agent-Skills
- 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
9jscraik/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.
Agentation
9jscraik/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.
Agents Md
9jscraik/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.
Internal Double Crux
5EquiStamp/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
Improve Agent Native
9jscraik/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.
LLM Wiki
9jscraik/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.
Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.