correction-capture

Scan Claude Code session transcripts to detect owner corrections and emit candidates for memory records.

Updated Jun 9, 2026
One-click install
npx skills add https://github.com/timikalo7/Execute --skill correction-capture-timikalo7
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: correction-capture
Source: https://github.com/timikalo7/Execute/tree/main/.claude/skills/correction-capture
Command: npx skills add https://github.com/timikalo7/Execute --skill correction-capture-timikalo7

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Owner corrections — the moments a user says "no, that's wrong" — are the highest-value learning signals in an agent system, yet they survive only when someone remembers to write them down. This Skill scans session transcripts so those corrections are captured systematically instead of being lost when the session ends. ## Core Features & Use Cases - Transcript scanning: Parses Claude Code .jsonl transcripts and classifies user turns with a two-tier signal system (strong signals like "u didnt" or "thats not" stand alone; weak signals like "not" or "instead" require a second match). - Machine-turn filtering: Strips compaction summaries, injected skill bodies, tool results, and system reminders that arrive as user turns but were never typed by the owner. - Candidate reporting: Outputs scored correction candidates with the assistant text they corrected, leaving the final judgment to a human or the learner agent, which appends confirmed entries to memory/corrections.md. - Use Case: At the end of a build milestone, run the scanner over the session transcript to surface every moment the owner pushed back, then record the real ones so the next session does not repeat the mistake. ## Quick Start Ask the agent to run the correction-capture scanner on the latest session transcript and review the candidates before appending confirmed corrections to memory/corrections.md.

Frequently Asked Questions about correction-capture

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

FAQPage Schema
How do I find corrections in a Claude Code session transcript?

Run node scan.mjs from the skill directory to scan the newest transcript for the current project. Use --transcript to target a specific .jsonl file or --since with a date to limit results to recent turns.

How does the correction classifier avoid false positives?

It uses two signal tiers: strong patterns like second-person negation score enough alone, while weak words like "not" or "instead" need a second signal. A selftest with real must-flag and must-not-flag fixtures verifies both directions.

Why does the scanner filter some user-role messages?

Compaction summaries, injected skill bodies, and local-command output arrive as user turns but were not typed by the owner, and they contain corrective vocabulary. MACHINE_PREFIXES and tool_result stripping remove this machine text before classification.

Can the scanner recover corrections from past sessions?

No. It reads one transcript on one container, and containers are wiped between sessions, so corrections from deleted transcripts are unrecoverable. That is why confirmed corrections are committed to memory/corrections.md.

Does the scanner decide which corrections are real?

No. It emits scored candidates and explicitly states they are candidates. A human or the learner agent reviews them, keeps the real ones, and records what each correction actually changed.