the-agency-ai/.claude/skills/handoff
.claude/skills/handoff/SKILL.md
Write a session handoff using the handoff tool — archive, write, verify
$ install --global
skillsauthnpx skillsauth add the-agency-ai/the-agency .claude/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: Apr 24, 2026, 8:57 PM1.8s1 file scanned
SKILL.md
- description:
- Write a session handoff using the handoff tool — archive, write, verify
<!-- Flag #62/#63: allowed-tools removed. Inherit Bash(*) from settings.json. -->
Session Handoff
Write a handoff file for session continuity. Always use the handoff tool — never write handoff files manually.
Arguments
$ARGUMENTS: Optional trigger name (e.g.,pre-restart,phase-complete,discussion-milestone). Defaults tomanual.
Instructions
Step 1: Archive and signal
Run the handoff tool to archive the current handoff and prepare for a new one:
bash ./claude/tools/handoff write --trigger $ARGUMENTS
If $ARGUMENTS is empty, use --trigger manual.
Step 2: Write the handoff
Write the handoff file at the path the tool reported. Include:
- Date and context — date, branch, session/agent name
- What was done — completed work this session, key changes
- What's next — immediate next steps for a fresh session
- Key decisions — anything a new session needs to know
- Open items/blockers — unresolved issues, pending discussions
- Discussion queue — carried-forward discussion items
Integrity rule: before writing, check git status. If any implementation
files (.ts, .py, .bats, .sh, claude/tools/, hooks/, etc.) are uncommitted,
either commit them first OR clearly mark them as "in progress — uncommitted"
in the Current State section. Never write 'complete' for uncommitted work.
The handoff tool will automatically detect uncommitted impl files and emit a WARNING that you should include verbatim in the handoff Current State section. This is the audit trail — the next session reading the handoff sees exactly what was left dirty.
Step 3: Verify
Run bash ./claude/tools/handoff read to verify the handoff was written correctly.
Related Skills
the-agency-ai/src/claude/skills/worktree-sync
business
VerifiedTrustedCommunity
Sync worktree with master — merge, copy settings, run sandbox-sync, report changes
5SKILL.mdUpdated Apr 22, 2026
the-agency-ai/src/claude/skills/worktree-list
tools
VerifiedTrustedCommunity
List all git worktrees with status info (branch, clean/dirty, deps)
5SKILL.mdUpdated Apr 22, 2026
the-agency-ai/src/claude/skills/worktree-delete
tools
VerifiedTrustedCommunity
Remove a git worktree and optionally delete its branch
5SKILL.mdUpdated Apr 22, 2026
the-agency-ai/src/claude/skills/worktree-create
development
VerifiedTrustedCommunity
Create a new git worktree with dedicated branch and bootstrapped dev environment
5SKILL.mdUpdated Apr 22, 2026