session-readlisted
Install: claude install-skill the-agency-ai/the-agency
<!--
Flag #62/#63: allowed-tools removed. Inherits Bash(*) from
.claude/settings.json. Restricting to specific subcommand patterns at the
skill level silently blocks agents on permission prompts the agent cannot
see — see dispatch #171 for the devex incident that surfaced this trap.
-->
# Session Read
Extract a structured summary from a Claude Code session JSONL file.
## Arguments
`$ARGUMENTS` is a session ID (full UUID or partial prefix) or a session index from `/session-list`.
## Steps
1. **Find the JSONL file** matching the ID in `~/.claude/projects/`.
2. **Read the file** (use offset/limit for large files).
3. **Parse and extract** a structured summary:
### Session Metadata
- Session ID, date range, branch, directory
### User Messages (chronological)
- Timestamp and full content for each `type: "user"` line
### Tool Activity Summary
- Tool name and input summary (Bash commands, file paths, patterns, agent descriptions)
- Group consecutive tool calls
### Files Modified
- Unique file paths from Edit, Write, MultiEdit tool_use blocks
### Key Decisions
- Scan for "decided", "chose", "going with", "plan is", "approach:", "the fix is"
### Git Operations
- git commit messages, push/merge/rebase operations, branch changes
4. **Output** the summary in markdown format.
## Notes
- Large sessions may need chunked reading
- Focus on user messages and tool calls — skip thinking blocks and progress events