helderberto/handoff
skills/handoff/SKILL.md
Compact the current conversation into a handoff doc so a fresh agent can continue the work. Use when user asks to "handoff", "/handoff", "hand this off", or wants to end a session mid-task. Don't use for summarising completed work, writing PRDs/plans/ADRs, or committing changes.
$ install --global
skillsauthnpx skillsauth add helderberto/skills handoffInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 20, 2026, 2:54 AM232.5s1 file scanned
SKILL.md
- name:
- handoff
- description:
- Compact the current conversation into a handoff doc so a fresh agent can continue the work. Use when user asks to "handoff", "/handoff", "hand this off", or wants to end a session mid-task. Don't use for summarising completed work, writing PRDs/plans/ADRs, or committing changes.
- argument-hint:
- What will the next session be used for?
Handoff
Write a handoff document summarising the current conversation so a fresh agent can continue.
If the user passed arguments, treat them as a description of what the next session will focus on and tailor the doc accordingly.
Workflow
- Create the file —
mktemp /tmp/handoff-XXXXXX.md. Use the absolute path it returns. - Fill the template below.
- Print the path at the end so the user can paste it into the next session.
Template
# Handoff — <one-line goal>
## Goal
What the next session should accomplish. If `$ARGUMENTS` was passed, lead with it.
## State
- Branch: <branch>
- Uncommitted: <yes/no + short summary, or "clean">
- Last action: <what we just finished or were doing>
## Decisions made
Non-obvious choices already settled. Skip anything obvious from the code.
## Open questions
Explicit unknowns the next agent must resolve before progressing.
## Next steps
Concrete first action — a command, a file to open, a test to write.
## References
Paths or URLs to PRDs, plans, ADRs, issues, commits, diffs. Do NOT duplicate their content.
## Suggested skills
List skills the next session should likely invoke (e.g. `/hb:build`, `/hb:tdd`).
Rules
- Do not duplicate content already captured in other artifacts (PRDs, plans, ADRs, issues, commits, diffs). Reference them by path or URL.
- Keep it under ~80 lines. A handoff doc is a pointer, not a transcript.
- Omit sections that don't apply rather than padding with "N/A".
Error Handling
- If
mktempfails → fall back to/tmp/handoff-$(date +%s).mdand print the path. - If no arguments were passed → ask the user one question for the Goal section, then proceed.
Related Skills
helderberto/caveman
testing
VerifiedTrustedCommunity
Ultra-compressed communication mode. Cuts token usage ~75% by speaking like caveman while keeping full technical accuracy. Supports intensity levels: lite, full (default), ultra, wenyan-lite, wenyan-full, wenyan-ultra. Use when user says "caveman mode", "talk like caveman", "use caveman", "less tokens", "be brief", or invokes /caveman. Also auto-triggers when token efficiency is requested.
10SKILL.mdUpdated May 12, 2026
helderberto/create-skill
development
VerifiedTrustedCommunity
Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill, or asks "make a skill for X".
8SKILL.mdUpdated May 20, 2026
helderberto/zoom-out
development
VerifiedTrustedCommunity
Tell the agent to zoom out and give broader context or a higher-level perspective. Use when you're unfamiliar with a section of code or need to understand how it fits into the bigger picture.
8SKILL.mdUpdated May 12, 2026
helderberto/write-a-skill
development
VerifiedTrustedCommunity
Create new agent skills with proper structure and progressive disclosure. Use when user wants to create, write, or build a new skill, or asks "make a skill for X".
8SKILL.mdUpdated May 12, 2026