Skip to main content
affpapa.org
RU EN
skill CX Codex

session-reflection-analysis — Claude Code skill: review & setup

Analyzes Claude Code conversation history to uncover workflow friction and curb token usage. Ideal for running retrospectives after long coding sessions.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add harperreed/dotfiles --skill session-reflection-analysis -a claude-code
Open on GitHub

What session-reflection-analysis does

The skill inspects project records inside ~/.claude/projects/ to locate bottlenecks. Reading full *.jsonl files directly blows through context limits. Because of this, the workflow relies on jq to build a compact digest. It preserves timestamps, tool names, and truncated user inputs while discarding verbose payload responses.

Next, an exploration subagent inspects this condensed log. The subagent highlights recurring blunders, such as fetching identical files repeatedly or missing project instructions. It drafts a structured retrospective markdown document with concrete rules for CLAUDE.md and ideas for custom commands.

Without jq present on your system path, the summary step aborts immediately. The skill never applies changes to your repository on its own; it presents copy-paste recommendations and asks before touching files.

What it helps with

  • track down wasted tokens across recent Claude Code sessions
  • spot repetitive tool calls and redundant file reads
  • produce ready-to-use guidelines for CLAUDE.md
  • identify missing automation scripts and custom slash commands

Example prompts for the agent

  • Review our last session and check where we wasted context
  • Analyze project history from the past week and suggest CLAUDE.md rules
  • Inspect recent tool usage and generate an efficiency report

How to install session-reflection-analysis

1Skills CLI (Vercel)

npx skills add harperreed/dotfiles --skill session-reflection-analysis -a claude-code

2Manually: put the files in place

~/.claude/skills/session-reflection-analysis/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/session-reflection-analysis/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about session-reflection-analysis

How do I install session-reflection-analysis in Claude Code?

Run npx skills add harperreed/dotfiles --skill session-reflection-analysis -a claude-code. The definition is placed into ~/.claude/skills/session-reflection-analysis/SKILL.md.

What does session-reflection-analysis do?

It parses stored chat logs with jq to locate token waste and repeated errors, then outlines actionable workflow fixes in a markdown report.

What tools are required before running this skill?

You must have jq installed on your machine. Without it, the script fails to condense project session logs and exits.

Similar skills

All skills for Agent setup: memory, context, orchestration →
setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. 1,052,851installs ask-matt Matt Pocock Routes you to the right Matt Pocock skill or flow for the task at hand. Use it when you need a starting point for a feature, prototype, incoming issue, or hard bug. 766,587installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. CX Codex 282,859installs caveman-review JuliusBrussee Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler. CX Codex +1 411,800installs caveman-compress JuliusBrussee Compresses CLAUDE.md, todo lists, and other prose files into a shorter format while retaining a readable backup. CX Codex +1 411,500installs

From the same set26

uv Guides your AI agent through Python workflows using uv: dependency resolution, virtualenvs, PEP 723 scripts, CI, and multistage Docker builds. CX Codex +1 ★ 336repo stars swiftui-view-refactor This skill guides SwiftUI view cleanup, dependency injection, and Observation state handling. Use it when reorganizing existing screens or reviewing view architecture. CX Codex +1 ★ 336repo stars releasing-software This skill walks through release checks, from builds and tests to CI and tagging. Use it to hold off on a tag until CI succeeds. CX Codex +1 ★ 336repo stars native-app-performance A skill that profiles native macOS and iOS apps with xctrace and Time Profiler. Instruments traces get analyzed from the terminal, no Instruments UI needed. CX Codex +1 ★ 336repo stars ios-debugger-agent Controls a booted iOS simulator via XcodeBuildMCP to build schemes and inspect on-screen UI elements. CX Codex +1 ★ 336repo stars humanizer This skill spots common AI-writing patterns and rewrites them while preserving the text’s meaning and intended tone. Use it to revise drafts or review finished copy. CX Codex +1 ★ 336repo stars summarize-meetings A skill that reads meeting transcripts in an Obsidian vault, pulls out people, action items and ideas, then writes summary files and links between notes. CX Codex +1 ★ 336repo stars strategy-diagnosis Runs structured diagnostic frameworks to help founders and operators dissect tough business problems step by step. CX Codex +1 ★ 336repo stars

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor