claude-session-data-schema-reference
Claude Code Session Log Schema
Reference skill for the JSONL session log format written by Claude Code under ~/.claude/projects/.
All claims in the reference are sourced from direct JSONL file inspection and verified against the LM Assist TypeScript source. No fields are inferred.
When to Load
Load ./references/schema.md when you need:
- Directory structure and project-key encoding rules
- Complete record type discriminator (
system,user,assistant,result,progress,summary,file-history-snapshot) - Field-level schema for each record type
- Tool call / tool result pairing algorithm
- Subagent and team session file naming conventions
- Task, plan, and team configuration paths
- Hook integration — how
PostToolUsetool_responsemaps totool_result.content - What is NOT in the logs (per-tool token costs, streaming events, hook records, per-tool timing)
Source
Schema verified 2026-03-24. Source reference: ./references/schema.md.
More from jamie-bitflight/claude_skills
perl-lint
This skill should be used when the user asks to lint Perl code, run perlcritic, check Perl style, format Perl code, run perltidy, or mentions Perl Critic policies, code formatting, or style checking.
24brainstorming-skill
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or when users request help with ideation, marketing, and strategic planning. Explores user intent, requirements, and design before implementation using 30+ research-validated prompt patterns.
11design-anti-patterns
Enforce anti-AI UI design rules based on the Uncodixfy methodology. Use when generating HTML, CSS, React, Vue, Svelte, or any frontend UI code. Prevents "Codex UI" — the generic AI aesthetic of soft gradients, floating panels, oversized rounded corners, glassmorphism, hero sections in dashboards, and decorative copy. Applies constraints from Linear/Raycast/Stripe/GitHub design philosophy: functional, honest, human-designed interfaces. Triggers on: UI generation, dashboard building, frontend component creation, CSS styling, landing page design, or any task producing visual interface code.
7python3-review
Comprehensive Python code review checking patterns, types, security, and performance. Use when reviewing Python code for quality issues, when auditing code before merge, or when assessing technical debt in a Python codebase.
7hooks-guide
Cross-platform hooks reference for AI coding assistants — Claude Code, GitHub Copilot, Cursor, Windsurf, Amp. Covers hook authoring in Node.js CJS and Python, per-platform event schemas, inline-agent hooks and MCP in agent frontmatter, common JSON I/O, exit codes, best practices, and a fetch script to refresh docs from official sources. Use when writing, reviewing, or debugging hooks for any AI assistant.
7agent-creator
Create high-quality Claude Code agents from scratch or by adapting existing agents as templates. Use when the user wants to create a new agent, modify agent configurations, build specialized subagents, or design agent architectures. Guides through requirements gathering, template selection, and agent file generation following Anthropic best practices (v2.1.63+).
6