Agent skill

Handoff

by damus-io in damus-io/notedeck

Hand off to a fresh Dave session — ask the user what to work on next, spawn a new session in the current worktree, and send it the task as its first message.

Custom licenceAuto-check passedAgent Workflows

Install Handoff

skills CLI
$ npx skills add damus-io/notedeck --skill handoff -a claude-code

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

GitHub CLI
$ gh skill install damus-io/notedeck handoff --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/damus-io/notedeck.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/handoff .claude/skills/handoff && 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
handoff
GitHub stars
316
Token cost
~1.5k tokens
SKILL.md length
870 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
Custom licence

At a glance

Hand off to a fresh Dave session — ask the user what to work on next, spawn a new session in the current worktree, and send it the task as its first message.

  • Works in 3 steps: Decide the task → Spawn + send, in one command → Report back
  • The user wants to delegate the next unit of work to a brand-new agentic session rather than continue in this one — e.g
  • SKILL.md covers 1. Decide the task, 2. Spawn + send, in one command, A --wait timeout does NOT mean… and 3. Report back, plus 1 more section
  • Calls jq

What it does

Handoff is an agent skill from damus-io/notedeck. Hand off to a fresh Dave session — ask the user what to work on next, spawn a new session in the current worktree, and send it the task as its first message. Use when the user wants to delegate the next unit of work to a brand-new agentic session rather than continue in this one — e.g. "/handoff", "hand this off", "spawn a session to do X next", "start a fresh session on the next task".

Its SKILL.md is about 1.5k 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 Git worktrees.

When your agent uses it

  • The user wants to delegate the next unit of work to a brand-new agentic session rather than continue in this one — e.g
  • Tasks that involve Git worktrees

Example prompts

  • “/handoff”
  • “hand this off”
  • “spawn a session to do X next”
  • “/handoff”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Decide the task
  2. Spawn + send, in one command
  3. Report back

What it can do on your machine

Read from SKILL.md and the folder at commit 33e57be. 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:

    • jq

    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

Handoff loads about 1.5k tokens when it runs. Until then it costs about 99 tokens; SKILL.md has 870 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 870 words (~1,512 tokens).

“/handoff starts a new Dave agentic session in the current worktree and seeds it with the next task, so this session can wrap up while a fresh one picks up with clean context. It's a single agentium spawn call (see…”

— opening of SKILL.md by damus-io, Custom licence
name
handoff

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/handoff of damus-io/notedeck.

Open the folder on GitHubat commit 33e57be

Compare with similar skills

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.

Handoff compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Handoff this skilldamus-io/notedeck316—~1.5kAutomated safety check: PassCustom licence
Orca CLIstablyai/orca87k2 repos~593Automated safety check: PassMIT
Using Git Worktreesjulianromli/opencode-template14428 repos~1.4kAutomated safety check: PassNone
Nagentdavidondrej/skills4.1k—~1.7kAutomated safety check: NotesMIT
Using Git Worktreesfarm-fe/farm5.6k13 repos~2kAutomated safety check: PassMIT
Agent of Empires Session Manageragent-of-empires/agent-of-empires3.3k—~2.1kAutomated safety check: PassMIT

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
  • Using Git Worktrees

    julianromli/opencode-template

    A skill your agent uses when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory…

    144 GitHub starsUsed in 28 repos~1.4k tokens
    Agent WorkflowsAuto-check passed
  • Nagent

    davidondrej/skills

    Launch a new bb worker thread with the right project, model, worktree, and task brief.

    4.1k GitHub stars~1.7k tokensUpdated today
    Agent WorkflowsAuto-check: notes
  • A skill your agent uses when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git…

    5.6k GitHub starsUsed in 13 repos~2k tokens
    Agent WorkflowsAuto-check passed
  • Agent of Empires Session Manager

    agent-of-empires/agent-of-empires

    Starts, monitors and organizes coding agent sessions that run in tmux through the aoe command, including groups, profiles and worktree-based parallel work.

    3.3k GitHub stars~2.1k tokensUpdated yesterday
    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.

    576 GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from damus-io/notedeck

  • Notebook

    damus-io/notedeck

    Read and edit a notebook canvas from the command line via the notebook CLI (crates/notebookcli).

    316 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed
  • Agentium

    damus-io/notedeck

    Query and control Dave agentic sessions from the command line via the agentium CLI (crates/agentiumcli), and find your OWN session's agentium: reference.

    316 GitHub stars~7.1k tokensUpdated yesterday
    Auto-check passed
  • Headway

    damus-io/notedeck

    Read and edit a Headway kanban board from the command line via the headway CLI (crates/headwaycli).

    316 GitHub stars~8.5k tokensUpdated yesterday
    Auto-check passed

Questions about Handoff

What does Handoff do?

Hand off to a fresh Dave session — ask the user what to work on next, spawn a new session in the current worktree, and send it the task as its first message. Handoff is an agent skill from damus-io/notedeck. Hand off to a fresh Dave session — ask the user what to work on next, spawn a new session in the current worktree, and send it the task as its first message.

When should I use Handoff?

Handoff fits situations like: the user wants to delegate the next unit of work to a brand-new agentic session rather than continue in this one — e.g; tasks that involve Git worktrees.

How do I install Handoff in Claude Code?

Run `npx skills add damus-io/notedeck --skill handoff -a claude-code`. Or copy the skill folder (.claude/skills/handoff in damus-io/notedeck) into .claude/skills/handoff in your project. Claude Code loads it when a task matches its description.

How do I install Handoff in Codex?

Run `npx skills add damus-io/notedeck --skill handoff -a codex`. Or copy the skill folder (.claude/skills/handoff in damus-io/notedeck) into .agents/skills/handoff in your project. Codex loads it when a task matches its description.

Can I use 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 damus-io/notedeck --skill 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/handoff, .gemini/skills/handoff, .github/skills/handoff and .opencode/skills/handoff in your project.

What does Handoff need to run?

Going by SKILL.md and its folder, Handoff needs the command-line tools its instructions call (jq).

Does Handoff 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 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 Handoff use?

Handoff has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Handoff use?

About 1.5k tokens (SKILL.md is roughly 6k 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 Handoff?

Skills that share tags, products or a category with Handoff: Orca CLI (stablyai/orca, 87k stars), Using Git Worktrees (julianromli/opencode-template, 144 stars), Nagent (davidondrej/skills, 4.1k stars) and Using Git Worktrees (farm-fe/farm, 5.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Handoff?

damus-io (a GitHub organization) maintains it in damus-io/notedeck, which has 316 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 6, 2026.

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