session:summary
Productivitysession:summary is an Agent Skill for productivity published in the kagenti/kagenti repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Update the pinned summary comment on a GitHub PR or issue with aggregated session stats
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/kagenti/kagenti/blob/HEAD/.claude/skills/session:summary/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/session-summary, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
flowchart TD
START(["/session:summary"]) --> DETECT["Detect PR/issue from branch"]
DETECT --> SCAN["Scan existing session comments"]:::phase
SCAN --> AGGREGATE["Aggregate stats across sessions"]:::phase
AGGREGATE --> PIN["Update pinned summary comment"]:::phase
PIN --> DONE([Summary updated])
classDef phase fill:#2196F3,stroke:#333,color:white
Follow this diagram as the workflow.
Update Pinned Summary
Update the pinned summary comment on a GitHub PR or issue. The summary always recalculates from individual session comments already posted on the PR/issue.
Workflow
Step 1: Detect PR/Issue Number
Auto-detect the PR from the current git branch:
gh pr list --head "$(git branch --show-current)" --json number --jq '.[0].number'
If no PR is found, ask the user for an issue number.
Step 2: Detect Repository
git remote get-url origin | sed 's/.*github.com[:/]\(.*\)\.git/\1/' | sed 's/.*github.com[:/]\(.*\)/\1/'
Step 3: Run the Summary Phase
Execute the summary phase of the analytics pipeline:
python3 .claude/scripts/session-analytics.py \
--phase summary \
--number <PR_OR_ISSUE_NUMBER> \
--repo <OWNER/NAME>
This will:
- Fetch all comments on the PR/issue
- Identify session stat comments (by their marker format)
- Aggregate metrics across all sessions (total tokens, costs, tool calls, duration)
- Create or update the pinned summary comment at the top of the conversation
Step 4: Verify
Confirm the summary was updated:
gh pr view <NUMBER> --json comments --jq '[.comments[] | select(.body | contains("Session Summary"))] | length'
Parameters
| Parameter | Source | Required |
|---|---|---|
--phase | Always summary | Yes |
--number | Auto-detected from branch | Yes |
--repo | Auto-detected from git remote | Yes |
Notes
- The summary comment is idempotent: running it multiple times updates the same comment
- It recalculates from scratch each time, so it always reflects the latest session data
- If no session comments exist on the PR/issue, the summary will indicate zero sessions
Related Skills
session- Router skill for all session analyticssession:post- Post session stats to PR/issue commentsession:extract- Extract analytics to CSV/MD/HTMLsession:dashboard- Generate HTML dashboard