File-Based Planning in Arabic
OthmanAdi/planning-with-files
Arabic edition of a file-based planning skill that keeps task_plan.md, findings.md and progress.md on disk so multi-step agent work survives lost context.
A skill your agent uses when a working session is ending, the context window is nearly full, work needs to pass to a teammate or a fresh session, or the user says "hand this off", "write this up…
Install Session Handoff
$ npx skills add OneWave-AI/claude-skills --skill session-handoff -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install OneWave-AI/claude-skills session-handoff --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/OneWave-AI/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/session-handoff .claude/skills/session-handoff && rm -rf skills-srcUse ~/.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/
Install the "session-handoff" agent skill from https://github.com/OneWave-AI/claude-skills/tree/main/session-handoff into .claude/skills/session-handoff/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "session-handoff", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/OneWave-AI/claude-skills/tree/main/session-handoffType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add OneWave-AI/claude-skills --skill session-handoff -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install OneWave-AI/claude-skills session-handoff --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/OneWave-AI/claude-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/session-handoff .agents/skills/session-handoff && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "session-handoff" agent skill from https://github.com/OneWave-AI/claude-skills/tree/main/session-handoff into .agents/skills/session-handoff/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "session-handoff", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add OneWave-AI/claude-skills --skill session-handoff -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install OneWave-AI/claude-skills session-handoff --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/OneWave-AI/claude-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/session-handoff .cursor/skills/session-handoff && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "session-handoff" agent skill from https://github.com/OneWave-AI/claude-skills/tree/main/session-handoff into .cursor/skills/session-handoff/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "session-handoff", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/OneWave-AI/claude-skills.git --path session-handoff--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add OneWave-AI/claude-skills --skill session-handoff -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install OneWave-AI/claude-skills session-handoff --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/OneWave-AI/claude-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/session-handoff .gemini/skills/session-handoff && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "session-handoff" agent skill from https://github.com/OneWave-AI/claude-skills/tree/main/session-handoff into .gemini/skills/session-handoff/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "session-handoff", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install OneWave-AI/claude-skills session-handoffInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add OneWave-AI/claude-skills --skill session-handoff -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/OneWave-AI/claude-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/session-handoff .github/skills/session-handoff && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "session-handoff" agent skill from https://github.com/OneWave-AI/claude-skills/tree/main/session-handoff into .github/skills/session-handoff/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "session-handoff", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add OneWave-AI/claude-skills --skill session-handoff -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install OneWave-AI/claude-skills session-handoff --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/OneWave-AI/claude-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/session-handoff .opencode/skills/session-handoff && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "session-handoff" agent skill from https://github.com/OneWave-AI/claude-skills/tree/main/session-handoff into .opencode/skills/session-handoff/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "session-handoff", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
session-handoff- GitHub stars
- 328
- Token cost
- ~996 tokens
- SKILL.md length
- 466 words
- Files
- 1
- Skills in repo
- 69
- Repo updated
- First seen
- Licence
- MIT
At a glance
A skill your agent uses when a working session is ending, the context window is nearly full, work needs to pass to a teammate or a fresh session, or the user says "hand this off", "write this up…
- A working session is ending
- SKILL.md covers Core Behavior, What Goes In It, How to Gather It and Rules, plus 1 more section
- Calls git
- The context window is nearly full
What it does
Session Handoff is an agent skill from OneWave-AI/claude-skills. Use when a working session is ending, the context window is nearly full, work needs to pass to a teammate or a fresh session, or the user says "hand this off", "write this up before we lose it", "I'm starting a new session", or "summarize where we are". Produces a handoff document that lets the next session resume without re-reading the transcript.
Its SKILL.md is about 1000 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Agent Workflows, covering Session handoff and Context engineering. It works with Git. The repository describes itself as: 200+ production-ready Claude Code skills for sales, marketing, design, engineering, and AI agent architecture. Built and maintained by OneWave AI. The licence is MIT.
When your agent uses it
- A working session is ending
- The context window is nearly full
- Work needs to pass to a teammate
- A fresh session
Example prompts
- “hand this off”
- “write this up before we lose it”
- “m starting a new session”
- “/session-handoff”
What it can do on your machine
Read from SKILL.md and the folder at commit fc5b785. 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
Shell commands in SKILL.md call:
git
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use git, 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 Handoff loads about 996 tokens when it runs. Until then it costs about 92 tokens; SKILL.md has 466 words of instructions outside code blocks.
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 OneWave-AI/claude-skills at commit fc5b785, republished under its MIT licence (© OneWave-AI). 466 words, ~996 tokens.
Download SKILL.mdSave it as
.claude/skills/session-handoff/SKILL.md (or your agent's skills folder).- name
- session-handoff
- description
- Use when a working session is ending, the context window is nearly full, work needs to pass to a teammate or a fresh session, or the user says "hand this off", "write this up before we lose it", "I'm starting a new session", or "summarize where we are". Produces a handoff document that lets the next session resume without re-reading the transcript.
Session Handoff
A session ends three ways: the context fills up, the person leaves, or the work moves to someone else. All three lose the same thing — the reasoning that never made it into a file. This skill writes that reasoning down before it evaporates.
Core Behavior
Write a handoff file, do not summarize in chat. Chat scrolls away; a file survives a /clear, a crash, and a different person opening the repo tomorrow.
Default path: HANDOFF.md at the repo root, or docs/handoff/<yyyy-mm-dd>-<topic>.md if the repo already has a docs convention. If a handoff file exists, append a new dated section rather than overwriting — the history of what was tried is half the value.
What Goes In It
Write these sections in this order. Skip a section only when it is genuinely empty.
Goal. One sentence: what this work is supposed to achieve, in the user's terms, not the ticket's.
State. What is done, what is half-done, what has not been started. Be specific about half-done — "auth works, but the refresh-token path is stubbed and returns a fixed string" beats "auth in progress".
Files touched. Path plus one line on what changed and why. Include files you read and decided not to change when the decision was non-obvious.
Decisions and why. The choices a reasonable person would question. Each one: what was chosen, what was rejected, and the reason. This is the section that saves the next session an hour.
Dead ends. What was tried and did not work. Name the failure mode. Without this, the next session repeats it.
Next step. The single next action, concrete enough to start on immediately. Not "continue the refactor" — "extract parseInvoice from billing.ts:210 into its own module, then point the three callers at it".
Open questions. Anything waiting on a human. Name who, and what the question is.
Show full SKILL.md (161 more words)Show less
How to Gather It
Prefer evidence over memory:
git statusandgit diff --statfor what actually changed on disk.git log --oneline -15for what landed.- Test/build output from the last run, if there was one.
- The user's own words for the goal — quote them rather than paraphrasing into corporate language.
If the transcript disagrees with the repo, the repo wins. Say so in the handoff.
Rules
- No status-report padding. No "we made great progress". A handoff is field notes, not a stakeholder update.
- Include the commands to get back to a working state: the dev-server command, the test command, any env var that has to be set.
- Never claim something works that you did not see work. Write "untested" next to it.
- If work is on a branch, name the branch and the base it forked from.
- Uncommitted changes: say so explicitly at the top, and list them. That is the most common way work gets lost.
Output Format
# Handoff — <topic> — <date>
**Goal:** <one sentence>
**Branch:** <name> (base: <name>) · **Uncommitted:** <yes, list / no>
## State
- Done: ...
- In progress: ...
- Not started: ...
## Files
- `path/to/file.ts` — <what and why>
## Decisions
- <chose X over Y because Z>
## Dead ends
- <tried X, failed with Y — don't repeat>
## Next step
<one concrete action>
## Open questions
- <question> — needs <person>
## Getting back to work
```bash
<commands>
## When the Context Window Is the Reason
If the handoff is being written because context is nearly full, write the file first, before any other work. Then tell the user to start a fresh session and open the file. Do not try to squeeze in one more fix — a truncated handoff is worse than an early one.© OneWave-AI, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in session-handoff of OneWave-AI/claude-skills.
Open the folder on GitHubat commit fc5b785
Compare with similar skills
Session Handoff 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Session Handoff this skillOneWave-AI/claude-skills | 328 | — | ~996 | Automated safety check: Pass | MIT | |
| File-Based Planning in ArabicOthmanAdi/planning-with-files | 27k | — | ~3.2k | Automated safety check: Notes | MIT | |
| File-Based Planning in SpanishOthmanAdi/planning-with-files | 27k | — | ~3.8k | Automated safety check: Notes | MIT | |
| Beads Task Memorygastownhall/beads | 28k | — | ~1.2k | Automated safety check: Pass | MIT | |
| Session History Searchslopus/happy | 24k | — | ~3.1k | Automated safety check: Pass | MIT | |
| Memori Long-Term MemoryMemoriLabs/Memori | 17k | — | ~2k | Automated safety check: Notes | Custom licence |
Similar skills
File-Based Planning in Spanish
OthmanAdi/planning-with-files
Spanish edition of a planning skill that keeps a multi-step agent task on track with task_plan.md, findings.md and progress.md on disk, with recovery after a session reset.
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.
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.
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.
Codewhale Session Handoff
codewhale-hq/Codewhale
Writes a paste-ready handoff for the next agent session, opening with a state-check command block and separating done, suspected and blocked work.
More from OneWave-AI/claude-skills
All 69 skills in this repoCRM Data Cleanup
OneWave-AI/claude-skills
Finds duplicate and junk records in a CRM CSV export with fuzzy matching, normalizes fields and writes a reviewable merge plan plus import-ready files without touching the live CRM.
Design Export Repair
OneWave-AI/claude-skills
Repairs broken decks and PDFs exported from Claude Design or similar AI deck generators: clipped text, wrong fonts and corrupted .pptx package structure.
Bi Measure Builder
OneWave-AI/claude-skills
Writes, explains, debugs, and optimizes BI calculations - Power BI / Fabric DAX measures and calculated columns, Tableau calculated fields (FIXED/INCLUDE/EXCLUDE LOD expressions, table…
Bookkeeping Close
OneWave-AI/claude-skills
Categorizes transactions, reconciles bank and card statements to the ledger, works a month-end checklist and prepares a close package, without ever forcing a balance.
CSV and Excel Merger
OneWave-AI/claude-skills
Combines CSV, TSV and Excel files into one verified table with pandas, by stacking or joining, mapping columns, normalizing keys and removing duplicates.
Sec Filing Puller
OneWave-AI/claude-skills
Pulls financial statement numbers for US public companies straight from SEC EDGAR's free official XBRL APIs (companyfacts, companyconcept, frames, submissions) into a cited table.
Related
Works with
Categories
Questions about Session Handoff
What does Session Handoff do?
A skill your agent uses when a working session is ending, the context window is nearly full, work needs to pass to a teammate or a fresh session, or the user says "hand this off", "write this up…. Session Handoff is an agent skill from OneWave-AI/claude-skills. Use when a working session is ending, the context window is nearly full, work needs to pass to a teammate or a fresh session, or the user says "hand this off", "write this up before we lose it", "I'm starting a new session", or "summarize where we are".
When should I use Session Handoff?
Session Handoff fits situations like: A working session is ending; the context window is nearly full; work needs to pass to a teammate; A fresh session.
How do I install Session Handoff in Claude Code?
Run `npx skills add OneWave-AI/claude-skills --skill session-handoff -a claude-code`. Or copy the skill folder (session-handoff in OneWave-AI/claude-skills) into .claude/skills/session-handoff in your project. Claude Code loads it when a task matches its description.
How do I install Session Handoff in Codex?
Run `npx skills add OneWave-AI/claude-skills --skill session-handoff -a codex`. Or copy the skill folder (session-handoff in OneWave-AI/claude-skills) into .agents/skills/session-handoff in your project. Codex loads it when a task matches its description.
Can I use Session Handoff 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 OneWave-AI/claude-skills --skill session-handoff -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-handoff, .gemini/skills/session-handoff, .github/skills/session-handoff and .opencode/skills/session-handoff in your project.
What does Session Handoff need to run?
Going by SKILL.md and its folder, Session Handoff needs the command-line tools its instructions call (git).
Does Session Handoff access the network?
SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Session Handoff 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 Handoff use?
Session Handoff 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 Handoff use?
About 996 tokens (SKILL.md is roughly 4k 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 Handoff?
Skills that share tags, products or a category with Session Handoff: File-Based Planning in Arabic (OthmanAdi/planning-with-files, 27k stars), File-Based Planning in Spanish (OthmanAdi/planning-with-files, 27k 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 Handoff?
OneWave-AI (a GitHub organization) maintains it in OneWave-AI/claude-skills, which has 328 GitHub stars. The repository holds 69 skills in this directory. The repository was last updated on October 2, 2026.
Source: OneWave-AI/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.