context-report

Generate a context efficiency report from Claude Code session JSONL logs.

156|37|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/zeuikli/claude-code-workspace --skill context-report-zeuikli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: context-report
Source: https://github.com/zeuikli/claude-code-workspace/tree/main/.claude/skills/context-report
Command: npx skills add https://github.com/zeuikli/claude-code-workspace --skill context-report-zeuikli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you understand how efficiently your Claude Code sessions use context and tooling by turning raw session logs into a structured efficiency report.

Core Features & Use Cases

  • Model and delegation analysis: Estimates whether you rely too much on Opus and whether task delegation ratios are healthy.
  • Tool usage efficiency insights: Compares native search tools (Grep/Glob) against Bash-based workflows to highlight inefficiencies.
  • TodoWrite-based task tracking metrics: Quantifies progress-tracking behavior to encourage clearer execution plans.

Quick Start

Ask Claude to run context-report for your current project directory to generate a context efficiency score and actionable warnings.

Frequently Asked Questions about context-report

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

FAQPage Schema
How do I analyze Claude Code session logs to optimize token costs?

You can analyze Claude Code session logs to optimize token costs by running a context-report on your project directory. It extracts model usage and tool frequency from JSONL logs to generate a scored context efficiency breakdown and actionable warnings.

How does context efficiency scoring work for AI coding sessions?

Context efficiency scoring works by applying jq-based extraction to session JSONL logs to evaluate model mix, task delegation ratios, and tool choices. It compares native search tools against Bash workflows and quantifies TodoWrite frequency to calculate an overall efficiency score.

Do I need Bash and jq installed to extract tool usage metrics from JSONL logs?

Yes, you need Bash and jq installed to extract tool usage metrics. The context efficiency report requires Bash log scanning combined with jq-based extraction to parse models, tool_use names, and TodoWrite frequency from your raw session data.

What is the best way to track task delegation ratios and model usage in Claude Code?

The best way to track task delegation ratios and model usage is by generating a post-session retrospective report. This approach estimates whether you rely too heavily on Opus and evaluates if your delegation behavior and tool choices are healthy.

Why does my Claude Code workflow use too many tokens during tool execution?

Your workflow likely uses too many tokens due to inefficient tool choices, such as relying on Bash-based workflows instead of native search tools like Grep and Glob. Running a context efficiency report highlights these specific inefficiencies and provides warnings.