Write a handoff document summarising the current conversation so a fresh agent can continue the work.

Include a "suggested skills" section in the document, naming which skills the next agent should call the Skill tool for.

Do not duplicate content already captured in other artifacts (specs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead.

Redact any sensitive information, such as API keys, passwords, or personally identifiable information.

If the user passed arguments, treat them as a description of what the next session will focus on and tailor the doc accordingly.

Output

Save the output in .handoffs/ at the repo root (create the directory if it does not exist).

Filename: kebab-case, topical, no date in it (e.g. build-claude-skill.md).

Begin the file with the following YAML frontmatter: