Agent skill

Session Recap

by tombelieber in tombelieber/claude-view

A skill your agent uses when the user asks to recap, summarize, or review a Claude Code session — e.g.

MITAuto-check passedAgent Workflows

Install Session Recap

skills CLI
$ npx skills add tombelieber/claude-view --skill session-recap -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install tombelieber/claude-view session-recap --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/tombelieber/claude-view.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/plugin/skills/session-recap .claude/skills/session-recap && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
session-recap
GitHub stars
111
Token cost
~3k tokens
SKILL.md length
1,043 words
Files
2
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user asks to recap, summarize, or review a Claude Code session — e.g.

  • Works in 4 steps: Identify the session. If the user… → Fetch session details. Call the… → Present the recap in this format → …
  • The user asks to recap
  • SKILL.md covers Steps and Available Tools
  • Calls npx

What it does

Session Recap is an agent skill from tombelieber/claude-view. Use when the user asks to recap, summarize, or review a Claude Code session — e.g. 'recap my last session', 'what happened in that session', 'session summary'

Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file.

It sits in Agent Workflows, covering Session handoff. It works with Model Context Protocol. The repository describes itself as: 10 Claude sessions running. What are they doing? Live dashboard — monitor, cost tracking, search, sub-agent visibility. The licence is MIT.

When your agent uses it

  • The user asks to recap
  • Review a Claude Code session — e.g

Example prompts

  • “recap my last session”
  • “what happened in that session”
  • “session summary”
  • “/session-recap”

Requirements

  • Node.js
  • Pre-approved tools (allowed-tools): mcp__claude-view__list_sessions, mcp__claude-view__get_session

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Identify the session. If the user specified a session ID, use it. Otherwise, call the mcpclaude-viewlist_sessions tool with limit: 5 to…
  2. Fetch session details. Call the mcpclaude-viewget_session tool with the session ID.
  3. Present the recap in this format
  4. Keep it concise. The recap should fit in one screen. If there are more than 5 commits, show the top 5 and note "and N more".

What it can do on your machine

Read from SKILL.md and the folder at commit ff3cdd1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • mcp__claude-view__list_sessions
    • mcp__claude-view__get_session

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Session Recap loads about 3k tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 1,043 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from tombelieber/claude-view at commit ff3cdd1, republished under its MIT licence (© tombelieber). 1,043 words, ~2,976 tokens.

Download SKILL.mdSave it as .claude/skills/session-recap/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
session-recap
description
Use when the user asks to recap, summarize, or review a Claude Code session — e.g. 'recap my last session', 'what happened in that session', 'session summary'
allowed-tools
mcp__claude-view__list_sessions, mcp__claude-view__get_session

You have access to the claude-view MCP server which provides tools for monitoring, analyzing, and managing Claude Code sessions. The claude-view server must be running on localhost (it auto-starts via the plugin hook).

Important: All tool names are prefixed with mcp__claude-view__. When calling a tool, always use the full prefixed name.

Error handling: If a tool returns an error about the server not being detected, tell the user to start it with npx claude-view.

Session Recap

Summarize a Claude Code session using the claude-view MCP tools.

Steps

  1. Identify the session. If the user specified a session ID, use it. Otherwise, call the mcp__claude-view__list_sessions tool with limit: 5 to show recent sessions and ask which one to recap. If the user says "last session" or "most recent", use the first result.

  2. Fetch session details. Call the mcp__claude-view__get_session tool with the session ID.

  3. Present the recap in this format:

## Session Recap: [project] — [branch]

**Duration:** X minutes | **Model:** [model] | **Turns:** [turns]

### What was done
[2-3 sentence summary based on recent_commits and summary field]

### Commits
- `abc1234` — commit message
- `def5678` — commit message

### Metrics
- Input tokens: [input_tokens] | Output tokens: [output_tokens] | Cache hits: [cache_read_tokens]
- Cost efficiency: [from derived_metrics if available]
  1. Keep it concise. The recap should fit in one screen. If there are more than 5 commits, show the top 5 and note "and N more".

Available Tools

ToolDescription
Session Tools
list_sessionsList sessions with filters
get_sessionGet session details
search_sessionsGrep search across sessions
Stats Tools
get_statsDashboard statistics
get_fluency_scoreAI Fluency Score (0-100)
get_token_statsToken usage statistics
Live Tools
list_live_sessionsCurrently running sessions
get_live_summaryAggregate live session summary
Auth Tools
auth_post_sessionauth session
auth_delete_sessionauth session
auth_get_statusauth status
Classify Tools
classify_start_classificationTrigger a classification job.
classify_cancel_classificationCancel a running classification job.
classify_single_sessionClassify a single session synchronously.
classify_get_classification_statusGet classification status.
Claude Home Tools
claude_home_list_claude_homehome
Cli Tools
cli_create_session- Create a new tmux-backed CLI session.
Coaching Tools
coaching_list_rules- List all coaching rules from the rules directory.
coaching_apply_rule- Create a new coaching rule file.
coaching_remove_rule- Remove a coaching rule file.
Contributions Tools
contributions_get_contributionsMain contributions page data.
contributions_get_branch_sessionsSessions for a branch.
contributions_get_session_contributionSession contribution detail.
Devices Tools
devices_list_devices_handlerdevices
devices_terminate_others_handlerothers
devices_delete_device_handlerdevices {device_id}
Export Tools
export_sessionsExport all sessions.
Facets Tools
facets_facet_badgesQuality badges (outcome + satisfaction) for the requested session IDs
facets_trigger_facet_ingestStart facet ingest from the Claude Code insights cache
facets_pattern_alertCheck the most recent sessions for a negative satisfaction pattern
facets_facet_statsAggregate statistics across all session facets.
Health Tools
health_configconfig
health_checkHealth check endpoint.
health_get_statusGet index metadata and data freshness info.
Ide Tools
ide_get_detectGET /api/ide/detect — return cached list of installed IDEs.
ide_post_openPOST /api/ide/open — open a file in the requested IDE.
Insights Tools
insights_get_insightsCompute and return behavioral insights.
insights_get_benchmarksCompute personal progress benchmarks.
insights_get_categoriesReturns hierarchical category data.
insights_get_insights_modelsper-model usage aggregated from rollup tables.
insights_get_insights_projectsper-project usage aggregated from rollup tables.
insights_get_insights_trendsGet time-series trend data for charts.
insights_list_invocablesList all invocables with their usage counts.
Jobs Tools
jobs_list_jobsList all active jobs.
Live Tools
live_get_pricing- Return the model pricing table.
live_dismiss_all_closed- Dismiss all recently closed (in-memory only).
live_get_live_session- Get a single live session by ID.
live_dismiss_session- Dismiss from recently closed (in-memory only).
live_get_live_session_messages- Get the most recent messages for a live session.
Mcp Tools
mcp_get_mcp_serversreturns all deduplicated MCP server configurations.
Memory Tools
memory_get_all_memoriesreturns all memory entries grouped by scope.
memory_get_memory_fileread a single memory file.
memory_get_project_memoriesreturns memories for a specific project.
Monitor Tools
monitor_snapshot- One-shot JSON snapshot of current resources.
Oauth Tools
oauth_get_auth_identityGET /api/oauth/identity
oauth_get_oauth_usageGET /api/oauth/usage
oauth_post_oauth_usage_refreshPOST /api/oauth/usage/refresh
Pairing Tools
pairing_generate_qrGenerate a QR payload via Supabase pair-offer.
Plans Tools
plans_get_session_plans- returns plan documents for the session's slug.
Plugins Tools
plugins_list_plugins- Unified view of installed + available plugins.
plugins_list_marketplacesplugins marketplaces
plugins_marketplace_actionplugins marketplaces action
plugins_refresh_allall
plugins_refresh_statusstatus
plugins_list_ops_handlerList all queued/running/completed ops.
plugins_enqueue_opEnqueue a plugin mutation, return immediately.
Processes Tools
processes_cleanup_processesprocesses cleanup
processes_kill_processprocesses {pid} kill
Projects Tools
projects_list_projectslist all projects backed by the in-memory catalog.
projects_list_project_branchesList distinct branches with session counts.
projects_list_project_sessionspaginated sessions for one project.
Prompts Tools
prompts_list_promptsList prompt history with optional search/filter.
prompts_get_prompt_statsAggregate prompt statistics.
prompts_get_prompt_templatesDetected prompt templates.
Providers Tools
providers_list_providersproviders with session counts (count > 0 only, Claude Code always first).
providers_usagetoken/cost aggregates per foreign provider within a trailing window
Reports Tools
reports_list_reportsList all saved reports.
reports_get_previewAggregate preview stats for a date range.
reports_get_reportGet a single report.
reports_delete_reportDelete a report.
Sessions Tools
sessions_get_active_sessionsreturns all active session files from ~/.claude/sessions/.
sessions_list_branchesGet distinct list of branch names across all sessions.
sessions_estimate_costcost estimation (Rust-only, no sidecar).
sessions_session_activityActivity histogram for sparkline chart.
sessions_session_activity_richFull server-side activity aggregation.
sessions_bulk_archive_handlersessions archive
sessions_bulk_unarchive_handlersessions unarchive
sessions_archive_session_handlersessions {id} archive
sessions_get_file_historyList all file changes for a session.
sessions_get_file_diffhistory/:file_hash/diff?from=N&to=M
sessions_get_session_hook_eventsFetch hook events for a session.
sessions_get_session_messages_by_idGet paginated messages by session ID.
sessions_get_subagent_messagesPaginated blocks for a sub-agent.
sessions_unarchive_session_handlersessions {id} unarchive
sessions_interact_handlerResolve a pending interaction (permission, question, plan, elicitation).
sessions_get_interaction_handlerFetch the full interaction data for a session's pending interaction.
Settings Tools
settings_get_claude_code_settingsreturns merged, redacted Claude Code settings.
settings_get_settingsRead current app settings.
settings_update_settingsUpdate app settings (partial).
settings_update_git_sync_intervalUpdate the git sync interval.
Share Tools
share_create_sharesessions {session_id} share
share_revoke_sharesessions {session_id} share
share_list_sharesshares
Stats Tools
stats_ai_generation_statsAI generation statistics with time range filtering.
stats_overviewAggregate usage statistics.
stats_storage_statsStorage statistics for the settings page.
stats_get_trendsGet week-over-week trend metrics.
Sync Tools
sync_indexing_status- lightweight JSON snapshot of indexing progress.
sync_trigger_deep_indexTrigger a full deep index rebuild.
sync_trigger_git_syncTrigger git commit scanning (A8.5).
System Tools
system_check_pathCheck whether a filesystem path still exists.
system_get_system_statusGet comprehensive system status.
system_clear_cacheClear obsolete search cache.
system_trigger_git_resyncTrigger full git re-sync.
system_trigger_reindexTrigger a full re-index.
system_reset_allFactory reset all data.
Teams Tools
teams_list_teamsList all teams.
teams_get_teamGet team detail.
teams_get_team_costGet team cost breakdown.
teams_get_team_inboxGet team inbox messages.
teams_get_team_sidechainsGet team member sidechains.
Telemetry Tools
telemetry_set_consentSet telemetry consent preference.
telemetry_ingest_eventingress for web journey events.
Turns Tools
turns_get_session_turns- Per-turn breakdown for a historical session.
Webhooks Tools
webhooks_list_webhookslist all webhooks (secrets excluded).
webhooks_create_webhookcreate a new webhook (returns signing secret once).
webhooks_get_webhookget a single webhook by ID.
webhooks_update_webhookupdate an existing webhook (partial update).
webhooks_delete_webhookremove a webhook from config and secrets.
webhooks_test_sendsend a synthetic test payload.
Workflows Tools
workflows_list_workflowsworkflows
workflows_create_workflowworkflows
workflows_control_runworkflows run {run_id} control
workflows_list_workflow_runsworkflows runs
workflows_get_workflow_run_detailworkflows runs {session_id} {run_id}
workflows_get_workflow_agent_detailworkflows runs {session_id} {run_id} agents {agent_id}
workflows_get_workflowworkflows {id}
workflows_delete_workflowworkflows {id}

© tombelieber, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in packages/plugin/skills/session-recap of tombelieber/claude-view.

  • SKILL.md
  • SKILL.md.tmpl

Open the folder on GitHubat commit ff3cdd1

Compare with similar skills

Session Recap next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Session Recap compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Session Recap this skilltombelieber/claude-view111—~3kAutomated safety check: PassMIT
MemPalace Task HandoffMemPalace/mempalace59k—~1.9kAutomated safety check: PassMIT
Memori MCP Memory UsageMemoriLabs/Memori17k—~3.8kAutomated safety check: PassMIT
Ourmemourmem/omem1741 repos~3.4kAutomated safety check: PassCustom licence
Context RecoverySakuraByteCore/codexmate354—~964Automated safety check: PassApache-2.0
Agent Manager Fleet TUIYoanWai/agent-manager580—~1kAutomated safety check: PassApache-2.0

Similar skills

  • MemPalace Task Handoff

    MemPalace/mempalace

    Creates, hands off, claims, executes and closes agent tasks through the MemPalace logstream, with approval of the exact task before it is recorded.

    59k GitHub stars~1.9k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Memori MCP Memory Usage

    MemoriLabs/Memori

    Teaches an MCP-connected agent when and how to call Memori's recall, summary, compaction, augmentation, feedback and quota tools to keep context across sessions.

    17k GitHub stars~3.8k tokensUpdated 7 days ago
    Agent WorkflowsAuto-check passed
  • Ourmem

    ourmem/omem

    Shared memory that never forgets. An agent skill from ourmem/omem.

    174 GitHub starsUsed in 1 repo~3.4k tokens
    Agent WorkflowsAuto-check passed
  • Context Recovery

    SakuraByteCore/codexmate

    Recovers project handoff context from local Codex, Claude Code, Gemini, CodeBuddy, and codexmate-derived sessions.

    354 GitHub stars~964 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Agent Manager Fleet TUI

    YoanWai/agent-manager

    Runs several coding-agent CLIs as real tmux sessions in one terminal UI, color-coded by whether each is working, waiting, idle or blocked.

    580 GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Claude Code Auto-Capture Hook

    NateBJones-Projects/OB1

    Fires a Stop hook that captures a Claude Code session transcript automatically when the session ends without a verbal wrap-up.

    4.7k GitHub stars~1.3k tokensUpdated today
    Agent WorkflowsAuto-check: notes

More from tombelieber/claude-view

All 13 skills in this repo
  • Claude View Coaching

    tombelieber/claude-view

    Reviews your Claude Code habits through the claude-view server, showing an AI Fluency Score and insights and letting you add or remove personal coaching rules.

    111 GitHub stars~3.1k tokensUpdated 9 days ago
    Auto-check passed
  • Claude Code Daily Cost Report

    tombelieber/claude-view

    Shows today's Claude Code spending through the claude-view MCP server, with total cost, running sessions and a per-session breakdown, and other date ranges on request.

    111 GitHub stars~3k tokensUpdated 9 days ago
    Auto-check passed
  • Export Claude Sessions

    tombelieber/claude-view

    Exports Claude Code session history from the claude-view server as JSON, filtered by date range or project, for backup or analysis elsewhere.

    111 GitHub stars~2.9k tokensUpdated 9 days ago
    Auto-check passed
  • Claude Code Behavioral Insights

    tombelieber/claude-view

    Pulls pattern, trend and benchmark data from the claude-view MCP server to present a behavioral analysis of your Claude Code usage, grouped by category.

    111 GitHub stars~3.1k tokensUpdated 9 days ago
    Auto-check passed
  • claude-view Project Overview

    tombelieber/claude-view

    Shows a dashboard for one project, or a table of all projects, from the claude-view MCP server: sessions, branches and contribution data.

    111 GitHub stars~3.1k tokensUpdated 9 days ago
    Auto-check passed
  • Claude Session Search

    tombelieber/claude-view

    Search your Claude Code session history through the claude-view MCP server, matching summaries, commit messages and project or branch names, and present the most relevant sessions.

    111 GitHub stars~3k tokensUpdated 9 days ago
    Auto-check passed

Categories

Questions about Session Recap

What does Session Recap do?

A skill your agent uses when the user asks to recap, summarize, or review a Claude Code session — e.g. Session Recap is an agent skill from tombelieber/claude-view.g.

When should I use Session Recap?

Session Recap fits situations like: the user asks to recap; review a Claude Code session — e.g.

How do I install Session Recap in Claude Code?

Run `npx skills add tombelieber/claude-view --skill session-recap -a claude-code`. Or copy the skill folder (packages/plugin/skills/session-recap in tombelieber/claude-view) into .claude/skills/session-recap in your project. Claude Code loads it when a task matches its description.

How do I install Session Recap in Codex?

Run `npx skills add tombelieber/claude-view --skill session-recap -a codex`. Or copy the skill folder (packages/plugin/skills/session-recap in tombelieber/claude-view) into .agents/skills/session-recap in your project. Codex loads it when a task matches its description.

Can I use Session Recap in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add tombelieber/claude-view --skill session-recap -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/session-recap, .gemini/skills/session-recap, .github/skills/session-recap and .opencode/skills/session-recap in your project.

What does Session Recap need to run?

Going by SKILL.md and its folder, Session Recap needs the command-line tools its instructions call (npx). Our summary lists: Node.js. Its frontmatter pre-approves these tools: mcp__claude-view__list_sessions, mcp__claude-view__get_session.

Does Session Recap access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Session Recap safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Session Recap use?

Session Recap is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Session Recap use?

About 3k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Session Recap?

Skills that share tags, products or a category with Session Recap: MemPalace Task Handoff (MemPalace/mempalace, 59k stars), Memori MCP Memory Usage (MemoriLabs/Memori, 17k stars), Ourmem (ourmem/omem, 174 stars) and Context Recovery (SakuraByteCore/codexmate, 354 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Session Recap?

tombelieber (a GitHub user) maintains it in tombelieber/claude-view, which has 111 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on September 30, 2026.

Source: tombelieber/claude-view on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.