Agent skill
summary
Generates weekly or monthly session summaries from retrospectives and activity logs.
Install this agent skill to your Project
npx add-skill https://github.com/goffity/claude-km-skill/tree/main/skills/summary
SKILL.md
Summary - Session Summaries
Generate weekly or monthly summaries from retrospectives, learnings, and activity logs.
Usage
/summary weekly # Generate current week summary
/summary monthly # Generate current month summary
/summary weekly 2026-01 # Generate for specific week/month
Output: $PROJECT_ROOT/docs/summaries/YYYY-MM-weekN.md or YYYY-MM.md
Instructions
1. Determine Period
Parse arguments:
weekly→ current week (Mon-Sun)monthly→ current month- Optional date parameter for historical summaries
export TZ='Asia/Bangkok'
YEAR=$(date '+%Y')
MONTH=$(date '+%m')
WEEK=$(date '+%V')
2. Gather Data
export TZ='Asia/Bangkok'
# Activity log entries for the period
grep "^$YEAR-$MONTH" docs/logs/activity.log
# Retrospectives for the period
find docs/retrospective/$YEAR-$MONTH -name "*.md" -type f | sort
# Learnings for the period
find docs/learnings/$YEAR-$MONTH -name "*.md" -type f | sort
# Git commits for the period
git log --oneline --since="[start-date]" --until="[end-date]"
# Knowledge base updates
git log --oneline --since="[start-date]" --until="[end-date]" -- docs/knowledge-base/
3. Analyze and Generate
Read each retrospective/learning file and extract:
- Task descriptions
- Types (feature, bugfix, refactor, etc.)
- Key decisions
- Open items (unchecked checkboxes)
4. Create Summary File
Use the template below.
5. Commit
git add docs/summaries/
git commit -m "docs: [weekly|monthly] summary for [period]"
Weekly Template
# Week [N] Summary ([start-date] - [end-date])
## Overview
| Metric | Value |
|--------|-------|
| Sessions | [count] |
| Issues Closed | [count] |
| PRs Merged | [count] |
| Learnings Captured | [count] |
## Sessions
| Date | Task | Type | Status | Issue |
|------|------|------|--------|-------|
| MM-DD | [task description] | feat/fix/refactor | completed/pending | #N |
## Key Accomplishments
- [accomplishment 1]
- [accomplishment 2]
## Learnings Captured
- `docs/learnings/[path]` - [title]
## Knowledge Distilled
- `docs/knowledge-base/[topic].md` - [title]
## Decisions Made
| Decision | Context | Rationale |
|----------|---------|-----------|
| [decision] | [context] | [rationale] |
## Open Items
- [ ] [carried over items from retrospectives]
## Next Week Focus
- [suggested focus areas based on open items]
Monthly Template
# [Month Year] Summary
## Overview
| Metric | Value |
|--------|-------|
| Total Sessions | [count] |
| Issues Closed | [count] |
| PRs Merged | [count] |
| Learnings | [count] |
| Knowledge Base Updates | [count] |
## Weekly Breakdown
| Week | Sessions | Key Focus |
|------|----------|-----------|
| W1 | [count] | [focus] |
| W2 | [count] | [focus] |
| W3 | [count] | [focus] |
| W4 | [count] | [focus] |
## Top Accomplishments
1. [accomplishment]
2. [accomplishment]
3. [accomplishment]
## Patterns & Trends
- [observed pattern in work]
- [recurring themes]
## Open Items Carried Over
- [ ] [items still pending]
## Next Month Priorities
- [priority 1]
- [priority 2]
Related Commands
| Command | Purpose |
|---|---|
/td |
Create retrospective (data source) |
/mem |
Capture learnings (data source) |
/consolidate |
Consolidate auto-captured files |
/summary |
Generate summaries (you are here) |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
goffity/claude-km-skill
commit
Creates atomic commits by invoking TDG and commenting on related GitHub issues.
goffity/claude-km-skill
distill
Synthesizes related learnings into reusable knowledge base patterns.
goffity/claude-km-skill
security-auditor
Audits code for security vulnerabilities including OWASP Top 10 and authentication issues.
goffity/claude-km-skill
code-reviewer
Reviews code changes for bugs, security vulnerabilities, and performance issues.
goffity/claude-km-skill
example
Saves reusable code examples to the examples library with metadata and tags.
goffity/claude-km-skill
flow
Documents workflow diagrams and process flows with Mermaid diagram support.
Didn't find tool you were looking for?