session-technical-summary

Archive AI coding sessions into incremental Markdown and HTML technical summaries.

Updated May 28, 2026
One-click install
npx skills add https://github.com/changfengpro/agent-skills --skill session-technical-summary-changfengpro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-technical-summary
Source: https://github.com/changfengpro/agent-skills/tree/main/skills/session-technical-summary
Command: npx skills add https://github.com/changfengpro/agent-skills --skill session-technical-summary-changfengpro

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? AI coding sessions in Claude Code and Codex disappear into local logs, making it hard to produce daily reports, technical retrospectives, or reusable documentation of what was investigated, fixed, and left pending. ## Core Features & Use Cases - Current Session Archiving: Summarizes the active conversation into an overview plus an incremental timeline entry, writing summary.md and a styled summary.html with a problem-navigation sidebar under $HOME/文档/AI-Session. - Date-Range Archiving: Collects evidence from local Claude Code JSONL logs and Codex rollout/state databases for today, yesterday, or any date range, then merges findings by project into a single range archive. - Incremental Updates: Rewrites the overview to reflect the latest state while appending only new facts to the call timeline, with Session ID mismatch protection to prevent mixing different sessions. - Use Case: At the end of a debugging day, ask for a range archive of today's sessions to get a report-ready summary with problem details, commands, errors, and follow-ups. ## Quick Start Call the session-technical-summary skill to archive today's AI sessions into a technical summary document.

Frequently Asked Questions about session-technical-summary

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

FAQPage Schema
How do I archive my Claude Code or Codex sessions into a summary?

Invoke the skill explicitly by name and specify the scope, such as the current session or a date range. It writes summary.md and summary.html under $HOME/文档/AI-Session, organized by date and session folder.

How do I generate a summary for today or the last few days of AI sessions?

Name the skill and state the range, such as today, yesterday, or the last N days. The collect_session_range.py script extracts evidence from local Claude Code JSONL logs and Codex rollout files, then the results are merged into one range archive.

Does the skill run automatically when a conversation ends?

No. The skill only runs when the user explicitly names session-technical-summary or asks to invoke it. Plain requests like summarize this or daily reports do not trigger it, and daily reports should use a dedicated daily-summary workflow instead.

Can summaries from different sessions get mixed into one document?

No. The write script checks the Session ID stored in an existing summary.md and refuses to write if it does not match the current session. Other sessions archived under the same date directory are ignored.

What dependencies are required to run the session summary scripts?

Only Python 3 with its standard library is required. The scripts use sqlite3, json, argparse, and optionally zoneinfo for timezones, with a fallback fixed UTC+8 offset when zoneinfo is unavailable.