Darwin Skill Optimizer
alchaincyf/darwin-skill
Scores SKILL.md files on a nine-dimension rubric, then improves them in a keep-or-revert loop with independent judge agents, test prompts, git history and human checkpoints.
A skill your agent uses when wrapping up or capturing the current state of a coding session — writes a short, dated entry to the repo's RepoHandover.md so a future agent or you can resume without…
Install Handover
The automated check flagged lines worth reading first. See the safety section below.
$ npx skills add jazzyalex/agent-sessions --skill handover -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install jazzyalex/agent-sessions handover --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/jazzyalex/agent-sessions.git skills-src && mkdir -p .claude/skills && cp -r skills-src/tools/handover .claude/skills/handover && 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 "handover" agent skill from https://github.com/jazzyalex/agent-sessions/tree/main/tools/handover into .claude/skills/handover/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "handover", 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/jazzyalex/agent-sessions/tree/main/tools/handoverType 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 jazzyalex/agent-sessions --skill handover -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install jazzyalex/agent-sessions handover --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jazzyalex/agent-sessions.git skills-src && mkdir -p .agents/skills && cp -r skills-src/tools/handover .agents/skills/handover && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "handover" agent skill from https://github.com/jazzyalex/agent-sessions/tree/main/tools/handover into .agents/skills/handover/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "handover", 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 jazzyalex/agent-sessions --skill handover -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install jazzyalex/agent-sessions handover --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jazzyalex/agent-sessions.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/tools/handover .cursor/skills/handover && 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 "handover" agent skill from https://github.com/jazzyalex/agent-sessions/tree/main/tools/handover into .cursor/skills/handover/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "handover", 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/jazzyalex/agent-sessions.git --path tools/handover--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 jazzyalex/agent-sessions --skill handover -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install jazzyalex/agent-sessions handover --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jazzyalex/agent-sessions.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/tools/handover .gemini/skills/handover && 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 "handover" agent skill from https://github.com/jazzyalex/agent-sessions/tree/main/tools/handover into .gemini/skills/handover/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "handover", 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 jazzyalex/agent-sessions handoverInstalls 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 jazzyalex/agent-sessions --skill handover -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/jazzyalex/agent-sessions.git skills-src && mkdir -p .github/skills && cp -r skills-src/tools/handover .github/skills/handover && 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 "handover" agent skill from https://github.com/jazzyalex/agent-sessions/tree/main/tools/handover into .github/skills/handover/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "handover", 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 jazzyalex/agent-sessions --skill handover -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install jazzyalex/agent-sessions handover --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jazzyalex/agent-sessions.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/tools/handover .opencode/skills/handover && 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 "handover" agent skill from https://github.com/jazzyalex/agent-sessions/tree/main/tools/handover into .opencode/skills/handover/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "handover", 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
handover- GitHub stars
- 895
- Token cost
- ~856 tokens
- SKILL.md length
- 425 words
- Files
- 4
- Skills in repo
- 8
- Repo updated
- First seen
- Licence
- MIT
At a glance
A skill your agent uses when wrapping up or capturing the current state of a coding session — writes a short, dated entry to the repo's RepoHandover.md so a future agent or you can resume without…
- Works in 4 steps: Draft from the conversation — do NOT run… → Compose a short entry in this format.… → Write it immediately — no approval prompt. → …
- Capturing the current state of a coding session — writes a short
- SKILL.md covers Procedure and Notes
- Runs Shell scripts from its folder; calls git
What it does
Handover is an agent skill from jazzyalex/agent-sessions. Use when wrapping up or capturing the current state of a coding session — writes a short, dated entry to the repo's RepoHandover.md so a future agent or you can resume without grepping archived sessions. Triggers on "handover", "hand off", "write handover", "capture state", "checkpoint this session".
Its SKILL.md is about 860 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `README.md`, `handover-lint.sh` and `install.sh`).
It sits in Agent Workflows. It works with Git. The repository describes itself as: Local-first macOS app to browse, search, analyze, and resume supported AI coding-agent session history across Codex, Claude Code, OpenCode, Cursor Agent, Antigravity, Hermes… The licence is MIT.
When your agent uses it
- Capturing the current state of a coding session — writes a short
- Dated entry to the repos RepoHandover.md so a future agent
- You can resume without grepping archived sessions
- Checkpoint this session
Example prompts
- “handover”
- “hand off”
- “write handover”
- “/handover”
Requirements
- A Bash shell
Workflow steps
4 steps, taken from the first numbered list in SKILL.md.
- Draft from the conversation — do NOT run a git audit. You already know what happened
- Compose a short entry in this format. Omit any line/section that would be empty.
- Write it immediately — no approval prompt.
- Report one line and stop. e.g. `Wrote handover to RepoHandover.md (superseded the
What it can do on your machine
Read from SKILL.md and the folder at commit b789596. 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 script files (Shell), which the agent can run.
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
Handover loads about 856 tokens when it runs. Until then it costs about 78 tokens; SKILL.md has 425 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: warnings
The automated check found patterns that need a careful read before installing.
- WarningTells the agent its actions are pre-authorized / not to stop for confirmationSKILL.md:11
write it directly — do NOT ask for approval or show a draft to confirm.** Just write, report
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 jazzyalex/agent-sessions at commit b789596, republished under its MIT licence (© jazzyalex). 425 words, ~856 tokens.
Download SKILL.mdSave it as
.claude/skills/handover/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.- name
- handover
- description
- Use when wrapping up or capturing the current state of a coding session — writes a short, dated entry to the repo's RepoHandover.md so a future agent or you can resume without grepping archived sessions. Triggers on "handover", "hand off", "write handover", "capture state", "checkpoint this session".
Handover
Append a short, dated entry to RepoHandover.md at the repo root (newest-first)
capturing where things stand, so you or a future agent can resume. Keep it lean — a handful
of lines, no git audit. The user already opted in by running /handover, so draft and
write it directly — do NOT ask for approval or show a draft to confirm. Just write, report
one line, and stop. Never commit.
Procedure
Draft from the conversation — do NOT run a git audit. You already know what happened this session. At most, run a single
git branch --show-currentif you want the branch in the header. Do not rungit status/log/diffsweeps — that's the verbosity we removed.Compose a short entry in this format. Omit any line/section that would be empty. Aim for ~8–15 lines total:
## <YYYY-MM-DD HH:MM> · <slug> · <title> status: in-progress # in-progress | blocked | done **State:** <one sentence — where things stand right now> **Decided / don't redo:** <only if there is something> - <a decision made, or a dead-end already tried> **Key files:** <only if it helps resume> - `path` — <why it matters> **Next:** 1. <the next concrete step> 2. <...>slug= the branch or plan/spec name (keep it stable — supersede-matching uses it).- Timestamp:
date +'%Y-%m-%d %H:%M'.
Write it immediately — no approval prompt.
New file → create
RepoHandover.mdwith this entry as its only content.Existing file → prepend the entry above the current top entry (blank line between). Don't touch older entries except the silent supersede below.
Ensure the repo's
CLAUDE.mdcontains this pointer (add it once, creating a shortCLAUDE.mdif absent):> Before starting work, read the newest entry in `RepoHandover.md`.Silent supersede: if an older entry has the same
slugand its status isn't alreadydoneorsuperseded-by:, change that older entry's status line tostatus: superseded-by:<new-entry-date>(one-line edit; leave its prose alone). No prompt.Never run
git commit.
Report one line and stop. e.g.
Wrote handover to RepoHandover.md (superseded the previous runway-auth entry). Not committed.Do not ask follow-up questions — the user is about to close/archive the session.
Show full SKILL.md (88 more words)Show less
Notes
- Lean by default. State + key decisions + next steps. No git verification dump, no "Verified/Believed" ceremony, no risk matrix.
- If the drafted entry is wrong, the user edits the file directly — it's short and uncommitted, so a bad entry is cheap. That's why no approval gate is needed.
- Sanity-check (optional, cheap):
handover-lint.sh RepoHandover.md— installed next to this skill — exits 0 when the newest entry's heading +status:line are well-formed. - Rotation: if
RepoHandover.mdpasses ~1000 lines, offer (never silently) to move all but the newest ~10 entries toRepoHandover-archive.md.
© jazzyalex, 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 in tools/handover of jazzyalex/agent-sessions.
- SKILL.md
- README.md
- handover-lint.sh
- install.sh
Open the folder on GitHubat commit b789596
Compare with similar skills
Handover 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 |
|---|---|---|---|---|---|---|
| Handover this skilljazzyalex/agent-sessions | 895 | — | ~856 | Automated safety check: Warn | MIT | |
| Darwin Skill Optimizeralchaincyf/darwin-skill | 6.2k | 1 repos | ~4.7k | Automated safety check: Pass | MIT | |
| CodeGraph Agent Evalcolbymchenry/codegraph | 74k | — | ~950 | Automated safety check: Pass | MIT | |
| Neat-Freak Knowledge CloseoutKKKKhazix/khazix-skills | 21k | — | ~1.9k | Automated safety check: Pass | MIT | |
| O2 Review Loopopenobserve/openobserve | 22k | — | ~3.7k | Automated safety check: Pass | AGPL-3.0 | |
| Beads Task Memorygastownhall/beads | 28k | — | ~1.2k | Automated safety check: Pass | MIT |
Similar skills
CodeGraph Agent Eval
colbymchenry/codegraph
Benchmarks how much CodeGraph helps a coding agent on a real repository, comparing runs with and without it for a chosen local or published version.
Neat-Freak Knowledge Closeout
KKKKhazix/khazix-skills
Brings project docs, agent rule files, authorized memory and leftover workspace files back in line with what the code and runtime actually do at the end of a work session.
O2 Review Loop
openobserve/openobserve
Splits a change into planner, coder and independent reviewer roles: you confirm a spec, a subagent implements it, and a separate reviewer checks each round's local WIP commit.
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.
More from jazzyalex/agent-sessions
All 8 skills in this repoSc Skill
jazzyalex/agent-sessions
Capture deterministic macOS screenshots for testing, docs, release notes, and marketing assets.
Add Agent Support
jazzyalex/agent-sessions
Create and ship AgentSessions support for a new or changed local AI agent/provider.
Deploy
jazzyalex/agent-sessions
A skill your agent uses when shipping a release of Agent Sessions — bumping version, updating CHANGELOG, building, signing, notarizing, publishing appcast, and creating a GitHub release.
Deploy Agent Sessions
jazzyalex/agent-sessions
Release/deploy workflow for Agent Sessions (Sparkle appcast + GitHub release).
Release Notes
jazzyalex/agent-sessions
A skill your agent uses when writing or curating the user-facing release copy for an Agent Sessions release — README "What's New", GitHub release notes, Sparkle release notes, or website/launch copy.
Agent Support Matrix
jazzyalex/agent-sessions
Maintain Agent Sessions agent support matrix and JSON/JSONL parsing compatibility.
Related
Works with
Categories
Questions about Handover
What does Handover do?
A skill your agent uses when wrapping up or capturing the current state of a coding session — writes a short, dated entry to the repo's RepoHandover.md so a future agent or you can resume without…. Handover is an agent skill from jazzyalex/agent-sessions.md so a future agent or you can resume without grepping archived sessions.
When should I use Handover?
Handover fits situations like: capturing the current state of a coding session — writes a short; dated entry to the repos RepoHandover.md so a future agent; you can resume without grepping archived sessions; checkpoint this session.
How do I install Handover in Claude Code?
Run `npx skills add jazzyalex/agent-sessions --skill handover -a claude-code`. Or copy the skill folder (tools/handover in jazzyalex/agent-sessions) into .claude/skills/handover in your project. Claude Code loads it when a task matches its description.
How do I install Handover in Codex?
Run `npx skills add jazzyalex/agent-sessions --skill handover -a codex`. Or copy the skill folder (tools/handover in jazzyalex/agent-sessions) into .agents/skills/handover in your project. Codex loads it when a task matches its description.
Can I use Handover 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 jazzyalex/agent-sessions --skill handover -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/handover, .gemini/skills/handover, .github/skills/handover and .opencode/skills/handover in your project.
What does Handover need to run?
Going by SKILL.md and its folder, Handover needs a shell for the scripts in its folder and the command-line tools its instructions call (git). Our summary lists: A Bash shell.
Does Handover 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 Handover safe to install?
Our automated static check of SKILL.md flagged 1 warning(s): tells the agent its actions are pre-authorized / not to stop for confirmation. Read the flagged lines before installing; the check is not a guarantee either way.
What licence does Handover use?
Handover 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 Handover use?
About 856 tokens (SKILL.md is roughly 3.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 Handover?
Skills that share tags, products or a category with Handover: Darwin Skill Optimizer (alchaincyf/darwin-skill, 6.2k stars), CodeGraph Agent Eval (colbymchenry/codegraph, 74k stars), Neat-Freak Knowledge Closeout (KKKKhazix/khazix-skills, 21k stars) and O2 Review Loop (openobserve/openobserve, 22k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Handover?
jazzyalex (a GitHub user) maintains it in jazzyalex/agent-sessions, which has 895 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 9, 2026.
Source: jazzyalex/agent-sessions on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.