oma-recap

Analyzes AI tool conversation histories and generates themed daily or multi-day work recaps.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/javiruu/viru-air --skill oma-recap-javiruu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: oma-recap
Source: https://github.com/javiruu/viru-air/tree/main/.agents/skills/oma-recap
Command: npx skills add https://github.com/javiruu/viru-air --skill oma-recap-javiruu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It turns scattered conversation histories from multiple AI tools (Grok, Claude, Codex, Qwen, Cursor, Antigravity) into a coherent, themed work summary, so you can recall what you accomplished without digging through raw logs. ## Core Features & Use Cases - Multi-tool history collection: Pulls normalized conversation data via oma recap --json with a Claude history.jsonl fallback when the CLI is unavailable. - Themed grouping: Groups work by content and project rather than by tool or chronology, with time-blocked themes for daily recaps and sprint-style project sections for multi-day windows. - Saved Markdown output: Writes recaps to .agents/results/recap/ with TL;DR, overview, themes, and tool usage patterns, respecting the configured response language. - Use Case: Ask for a recap of last week and receive a project-ordered sprint report summarizing milestones, decisions, and tool-switching patterns across all your AI coding sessions. ## Quick Start Ask the assistant to generate a recap of today's work across all AI tools and save it as a Markdown file.

Frequently Asked Questions about oma-recap

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

FAQPage Schema
How do I generate a daily work recap from AI conversation history?▼

Ask for a recap of a specific day or period, and the skill resolves the date, collects history via oma recap --json, groups sessions into themes, and writes a Markdown recap to .agents/results/recap/. No date defaults to today.

Which AI tools are supported for conversation history analysis?▼

Supported tools are Grok, Claude, Codex, Qwen, Cursor, and Antigravity. You can filter with the --tool flag, for example oma recap --tool claude,codex --json, to limit the recap to specific tools.

What happens if the oma recap CLI is not installed?▼

The skill falls back to parsing Claude history at ~/.claude/history.jsonl using jq, filtered by the target date's timestamp range. The recap then covers Claude only, and the limited scope is stated explicitly.

How are multi-day recaps structured differently from daily ones?▼

Windows of three days or longer use a project-driven sprint-report structure ordered by activity volume instead of day chronology. Small projects under 30 prompts are summarized as one-liners in a Side Projects section.

When should I not use conversation history recaps?▼

Do not use it for git commit-based code retrospectives, real-time agent monitoring, or productivity metrics. Those scenarios are handled by separate retro, dashboard, and stats capabilities instead.