# Oma Recap

Summarize AI conversation histories for a specified date or period.

- Repository: https://github.com/first-fluke/oh-my-agent (1356 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add first-fluke/oh-my-agent --skill oma-recap -g -a claude-code -y`
Codex: `npx skills add first-fluke/oh-my-agent --skill oma-recap -g -a codex -y`
Cursor: `npx skills add first-fluke/oh-my-agent --skill oma-recap -g -a cursor -y`
Gemini CLI: `npx skills add first-fluke/oh-my-agent --skill oma-recap -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add first-fluke/oh-my-agent`

## Description

Summarize AI conversation histories for a specified date or period. Use for daily work recaps and cross-tool activity summaries.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# AI Tool Conversation History Summary

Analyze AI tool conversation histories for a given period and generate themed work summaries.

## Scheduling

### Goal
Collect AI tool conversation history for a date or window and synthesize it into a themed, project-oriented recap with saved Markdown output.

### Intent signature
- User asks for daily recap, weekly/monthly summary, standup notes, work log, tool usage pattern, or AI conversation history analysis.
- User wants conversation histories grouped by work content rather than raw chronological logs.

### When to use
- Summarizing a day or period of work activity
- Understanding the overall flow of work across multiple AI tools
- Analyzing tool-switching patterns between sessions
- Preparing daily standups, weekly retros, or work logs

### When NOT to use
- Git commit-based code change retrospective -> use `oma retro`
- Real-time agent monitoring -> use `oma dashboard terminal`
- Productivity metrics -> use `oma stats get`

### Expected inputs
- Date, relative date, time window, or tool filter
- Conversation history available through `oma recap --json` or fallback sources
- Desired daily or multi-day recap scope

### Expected outputs
- Markdown recap saved to `.agents/results/recap/{date}.md` or range filename
- TL;DR, overview, themes/projects, miscellaneous or side projects, and tool usage patterns
- User-facing summary in configured response language

### Dependencies
- `oma recap --json`
- Optional Claude fallback history at `~/.claude/history.jsonl`
- `.agents/oma-config.yaml` for language behavior

### Control-flow features
- Branches by date resolution, window length, available tool history, and daily vs multi-day output shape
- Reads local history data and writes Markdown recap files
- Groups by content, not by tool

## Structural Flow

### Entry
1. Resolve requested date or window.
2. Collect normalized conversation history.
3. Decide daily versus multi-day output structure.

The rest: https://github.com/first-fluke/oh-my-agent/blob/HEAD/.agents/skills/oma-recap/SKILL.md