handoff

Create and update Obsidian-backed per-branch handoff notes for git worktrees.

15|1|Updated Jan 9, 2016
One-click install
npx skills add https://github.com/nanozuki/crows --skill handoff-nanozuki
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: handoff
Source: https://github.com/nanozuki/crows/tree/main/configs/agents/skills/handoff
Command: npx skills add https://github.com/nanozuki/crows --skill handoff-nanozuki

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Maintains an Obsidian-backed per-branch handoff note to help future sessions resume work on the same git branch across checkouts and worktrees. Use when the user invokes this skill or asks to read, create, or update a handoff note.

Core Features & Use Cases

  • Per-branch handoff notes persist in Obsidian, enabling quick resume of work after checkouts or new worktrees.
  • Create, read, and update handoff notes with concise context, decisions, blockers, and questions.
  • Notes are stored under the first Obsidian vault's Logbook path derived from the repository origin and current branch.

Quick Start

Use the handoff skill to create or update the handoff note for the current branch.

Frequently Asked Questions about handoff

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I preserve context when switching git branches in Obsidian?

Per-branch handoff notes in Obsidian preserve context when switching git branches by tracking goals, status, decisions, and open questions, enabling future sessions to quickly resume work after checkouts or worktree switches.

How do I create a handoff note for my current git branch?

Invoke the skill in your git repository to create a handoff note for the current branch. It resolves the origin remote and branch name, then saves a standard template covering goal, context, status, key decisions, and open questions into your Obsidian vault's Logbook path.

Does the handoff note skill work with git worktrees?

Yes, the handoff note skill works with git worktrees. It tracks context based on the branch name and origin remote, allowing you to resume work on the same branch seamlessly even when operating across multiple worktrees.

What do I need to use Obsidian notes for git branch tracking?

To use Obsidian notes for git branch tracking, you need a valid git repository with a current branch and an Obsidian vault. The skill resolves the vault path and stores handoff notes under the first vault's Logbook directory.

What is the best way to track project decisions and blockers across git checkouts?

Using per-branch Obsidian handoff notes is the best way to track decisions and blockers across git checkouts. They persist key decisions, context, and open questions in a structured template, ensuring no context is lost between sessions on the same branch.

Why are my git branch handoff notes not updating in Obsidian?

Git branch handoff notes fail to update when preconditions are unmet, such as lacking a valid git repository or current branch. The skill enforces these checks and requires resolving the first Obsidian vault's Logbook path before creating or updating notes.