the-agency-ai/src/claude/skills/session-read
src/claude/skills/session-read/SKILL.md
Read a past session and produce a structured summary (messages, tool calls, files, decisions)
$ install --global
skillsauthnpx skillsauth add the-agency-ai/the-agency src/claude/skills/session-readInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 22, 2026, 11:35 AM123.9s1 file scanned
SKILL.md
- description:
- Read a past session and produce a structured summary (messages, tool calls, files, decisions)
<!--
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
-
Find the JSONL file matching the ID in
~/.claude/projects/. -
Read the file (use offset/limit for large files).
-
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
- 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
Related Skills
the-agency-ai/src/claude/skills/worktree-sync
business
VerifiedTrustedCommunity
Sync worktree with master — merge, copy settings, run sandbox-sync, report changes
5SKILL.mdUpdated Apr 22, 2026
the-agency-ai/src/claude/skills/worktree-list
tools
VerifiedTrustedCommunity
List all git worktrees with status info (branch, clean/dirty, deps)
5SKILL.mdUpdated Apr 22, 2026
the-agency-ai/src/claude/skills/worktree-delete
tools
VerifiedTrustedCommunity
Remove a git worktree and optionally delete its branch
5SKILL.mdUpdated Apr 22, 2026
the-agency-ai/src/claude/skills/worktree-create
development
VerifiedTrustedCommunity
Create a new git worktree with dedicated branch and bootstrapped dev environment
5SKILL.mdUpdated Apr 22, 2026