New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Session Done

by vincentkoc in vincentkoc/dotskills

Prepare a concise session handoff when the user asks to wrap up, capture continuation context, or use /done.

MITAuto-check passedAgent Workflows

Install Session Done

skills CLI
$ npx skills add vincentkoc/dotskills --skill session-done -a claude-code

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

GitHub CLI
$ gh skill install vincentkoc/dotskills session-done --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/vincentkoc/dotskills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/session-done .claude/skills/session-done && 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-done
GitHub stars
107
Token cost
~833 tokens
SKILL.md length
355 words
Files
4 (incl. scripts, assets)
Skills in repo
19
Repo updated
First seen
Licence
MIT

At a glance

Prepare a concise session handoff when the user asks to wrap up, capture continuation context, or use /done.

  • Works in 6 steps: Use the current task's evidence. Record… → Include known session, branch,… → Return the handoff in chat by default.… → …
  • Asks to wrap up
  • SKILL.md covers Purpose, When to use, Workflow and Inputs, plus 2 more sections
  • Calls python3

What it does

Session Done is an agent skill from vincentkoc/dotskills. Prepare a concise session handoff when the user asks to wrap up, capture continuation context, or use /done. Retain a Markdown file only when requested.

Its SKILL.md is about 830 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and assets (for example `agents/openai.yaml`).

It sits in Agent Workflows, covering Session handoff. The repository describes itself as: 🐙 A curated set of Codex and OpenClaw skills for workflow automation, technical debugging, and agent-assisted development patterns. The licence is MIT.

When your agent uses it

  • Asks to wrap up
  • Capture continuation context

Example prompts

  • “/session-done”

Requirements

  • Python 3

Workflow steps

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

  1. Use the current task's evidence. Record completed work, validation and its limits, blockers, and the next owner/action. Do not scan…
  2. Include known session, branch, commit/PR, and retained-checkout identities when relevant. Mark unknown facts as unknown. Completion does…
  3. Return the handoff in chat by default. For deterministic Markdown, run python3 scripts/session-done --summary "..." --state "..."…
  4. If the user explicitly requested retention, use one named destination with --output . The parent must already exist; existing files and…
  5. Report the created path or exact failure. A failed write is not saved evidence. Preserve existing notes and recovery material; do not…
  6. Update memory only when the user directly requests it, through the environment's existing memory workflow. This writer never appends to…

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • python3

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

  • Network

    No URLs in SKILL.md.

    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 Done loads about 833 tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 355 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from vincentkoc/dotskills at commit b83ca13, republished under its MIT licence (© vincentkoc). 355 words, ~833 tokens.

Download SKILL.mdSave it as .claude/skills/session-done/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
session-done
description
Prepare a concise session handoff when the user asks to wrap up, capture continuation context, or use /done. Retain a Markdown file only when requested.
license
MIT
metadata.source
https://github.com/vincentkoc/dotskills

Session Done

Purpose

Capture the outcome, evidence, unresolved work, and next action without making session completion a cleanup or memory-write command.

When to use

  • The user asks for a session handoff, continuation summary, or /done.
  • The user requests a durable Markdown handoff, including a note in a PKM/Obsidian folder.

Workflow

  1. Use the current task's evidence. Record completed work, validation and its limits, blockers, and the next owner/action. Do not scan unrelated sessions or copy credentials, private logs, or raw transcripts.
  2. Include known session, branch, commit/PR, and retained-checkout identities when relevant. Mark unknown facts as unknown. Completion does not terminate sessions, remove worktrees, release owners, or rerun cleanup.
  3. Return the handoff in chat by default. For deterministic Markdown, run python3 scripts/session-done --summary "..." --state "..." --follow-ups "..."; it writes only stdout.
  4. If the user explicitly requested retention, use one named destination with --output <new-path>. The parent must already exist; existing files and symlinks are refused. A PKM/Obsidian folder can be that destination, without a second copy or sync service.
  5. Report the created path or exact failure. A failed write is not saved evidence. Preserve existing notes and recovery material; do not retry under new filenames automatically.
  6. Update memory only when the user directly requests it, through the environment's existing memory workflow. This writer never appends to shared memory or edits agent-managed memory files. Report that separate action's outcome.
Show full SKILL.md (125 more words)Show less

Inputs

  • At least one content flag: --summary, --decisions, --questions, --follow-ups, --state, --reflection, or --flashcards.
  • Optional --session-id and --branch: verified values; both default to unknown.
  • Optional --output: the explicitly requested new Markdown file. No environment variable enables retention, copying, or memory writes.

Outputs

  • Structured Markdown on stdout by default, containing only supplied sections plus metadata.
  • With --output, one UTF-8 file published from complete staged bytes without overwriting another note; success is reported on stderr. Temporary staging is confined to the destination directory and removed when the command exits normally or handles a write failure.
  • Atomic publication applies to that one file, not a multi-file transaction or power-loss durability guarantee. An interrupted process can leave its staging file; preserve unknown files instead of sweeping the directory.

Flow

mermaid
stateDiagram-v2
    [*] --> GatherCurrentEvidence
    GatherCurrentEvidence --> PrepareHandoff
    PrepareHandoff --> DeliverInChat: retention not requested
    PrepareHandoff --> PublishNewFile: retention explicitly requested
    PublishNewFile --> ReportSavedPath: destination new and write succeeds
    PublishNewFile --> ReportFailure: collision or write failure
    DeliverInChat --> [*]
    ReportSavedPath --> [*]
    ReportFailure --> [*]

© vincentkoc, 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 3 other files (scripts, assets) in skills/session-done of vincentkoc/dotskills.

  • SKILL.md
  • agents/openai.yaml
  • assets/icon.jpg
  • scripts/session-done

Open the folder on GitHubat commit b83ca13

Compare with similar skills

Session Done 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 Done compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Session Done this skillvincentkoc/dotskills107—~833Automated safety check: PassMIT
Orca CLIstablyai/orca87k2 repos~593Automated safety check: PassMIT
Coding Agent Session Findercode-yeongyu/oh-my-openagent70k1 repos~2.8kAutomated safety check: PassCustom licence
Beads Task Memorygastownhall/beads28k—~1.2kAutomated safety check: PassMIT
Session History Searchslopus/happy24k—~3.1kAutomated safety check: PassMIT
Paseo Agent Handoffgetpaseo/paseo20k1 repos~606Automated safety check: PassCustom licence

Similar skills

  • Orca CLI

    stablyai/orca

    Operate Orca-managed worktrees, folder contexts, terminals, repos, automations, artifacts, skill sharing, worktree comments, and Orca's embedded browser…

    87k GitHub starsUsed in 2 repos~593 tokens
    Agent WorkflowsAuto-check passed

  • Coding Agent Session Finder

    code-yeongyu/oh-my-openagent

    Finds, reads and reconstructs past coding-agent sessions across Codex, Claude, OpenCode, Senpi and many other local agent logs.

    70k GitHub starsUsed in 1 repo~2.8k tokens
    Agent WorkflowsAuto-check passed

  • Beads Task Memory

    gastownhall/beads

    Tracks multi-session work with dependencies in the bd issue tracker so the agent can find ready tasks and recover its context after conversation compaction.

    28k GitHub stars~1.2k tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Session History Search

    slopus/happy

    Searches past Claude Code, Codex and Cursor sessions and summarizes what was worked on, tried or decided, using extraction scripts instead of reading raw logs.

    24k GitHub stars~3.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed

  • Paseo Agent Handoff

    getpaseo/paseo

    Hands off the current task, including context, decisions and failed attempts, to a fresh agent through Paseo by writing a self-contained briefing prompt and launching that agent.

    20k GitHub starsUsed in 1 repo~606 tokens
    Agent WorkflowsAuto-check passed

  • Memori Long-Term Memory

    MemoriLabs/Memori

    Connects Claude Code to Memori Cloud for long-term memory, recalling stored context before substantive replies and saving new context afterward.

    17k GitHub stars~2k tokensUpdated 5 days ago
    Agent WorkflowsAuto-check: notes

More from vincentkoc/dotskills

All 19 skills in this repo

  • Openclaw PR Batch Sweep

    vincentkoc/dotskills

    Select, review, repair, validate, and land batches of up to 20 low-risk OpenClaw contributor pull requests using Vincent's maintainer preferences and bounded sub-agent lanes.

    107 GitHub stars~4.1k tokensUpdated today
    Auto-check passed

  • Tmux Agent Lane Orchestrator

    vincentkoc/dotskills

    Monitor and coordinate one tmux agent lane, reconstruct worker state from panes and recent Codex logs, classify progress and blockers, and produce concise manager summaries.

    107 GitHub stars~967 tokensUpdated today
    Auto-check passed

  • Codebase Memory MCP

    vincentkoc/dotskills

    Resolve canonical Git checkouts, index and verify codebase-memory-mcp graphs through the guarded CLI, and safely audit duplicate worktree caches.

    107 GitHub stars~3k tokensUpdated today
    Auto-check passed

  • Org Branch Cleanup

    vincentkoc/dotskills

    Audit and safely prune stale branches across a GitHub organization with immutable snapshots, conservative merged-PR classification, live SHA/protection/open-PR revalidation, resumable deletion…

    107 GitHub stars~1.5k tokensUpdated today
    Auto-check passed

  • Codex Goal Mining

    vincentkoc/dotskills

    Mine structured Codex /goal history locally or across a configured machine fleet, measure active goal time and resumed thread spans, identify unfinished and recurring semantic runs, and turn them…

    107 GitHub stars~1.2k tokensUpdated today
    Auto-check passed

  • Semantic Slicing

    vincentkoc/dotskills

    Build local semantic review slices by combining clawpatch feature maps, deepsec threat candidates, visual review maps, and optional gitcrawl/discrawl evidence for repos such as openclaw/openclaw.

    107 GitHub stars~2k tokensUpdated today
    Auto-check passed

Categories

Questions about Session Done

What does Session Done do?

Prepare a concise session handoff when the user asks to wrap up, capture continuation context, or use /done. Session Done is an agent skill from vincentkoc/dotskills. Prepare a concise session handoff when the user asks to wrap up, capture continuation context, or use /done.

When should I use Session Done?

Session Done fits situations like: asks to wrap up; capture continuation context.

How do I install Session Done in Claude Code?

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

How do I install Session Done in Codex?

Run `npx skills add vincentkoc/dotskills --skill session-done -a codex`. Or copy the skill folder (skills/session-done in vincentkoc/dotskills) into .agents/skills/session-done in your project. Codex loads it when a task matches its description.

Can I use Session Done 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 vincentkoc/dotskills --skill session-done -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-done, .gemini/skills/session-done, .github/skills/session-done and .opencode/skills/session-done in your project.

What does Session Done need to run?

Going by SKILL.md and its folder, Session Done needs the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Session Done access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Session Done 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Session Done use?

Session Done is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Session Done use?

About 833 tokens (SKILL.md is roughly 3.3k 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 Done?

Skills that share tags, products or a category with Session Done: Orca CLI (stablyai/orca, 87k stars), Coding Agent Session Finder (code-yeongyu/oh-my-openagent, 70k stars), Beads Task Memory (gastownhall/beads, 28k stars) and Session History Search (slopus/happy, 24k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Session Done?

vincentkoc (a GitHub user) maintains it in vincentkoc/dotskills, which has 107 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 8, 2026.

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