mdmagnuson-creator/session-handoff
skills/session-handoff/SKILL.md
Produce a Planner session handoff by writing the five structured fields to planner-state.json and emitting the standard copy/paste message for the next session. Use when asked to produce a handoff, update session state, or write a copy/paste message for the next Planner session.
documentation
Updated Apr 21, 2026
$ install --global
skillsauthnpx skillsauth add mdmagnuson-creator/yo-go session-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 30, 2026, 2:20 PM6.9s1 file scanned
SKILL.md
- name:
- session-handoff
- description:
- Produce a Planner session handoff by writing the five structured fields to planner-state.json and emitting the standard copy/paste message for the next session. Use when asked to produce a handoff, update session state, or write a copy/paste message for the next Planner session.
Session Handoff Skill
Use when: asked to produce a handoff, update session state, or write a copy/paste message for the next Planner session.
The five fields
currentIntent What the current work is trying to achieve. Not what happened — what we are pointed at. 2-3 sentences. Makes sense to someone with zero prior context.
recentDecisions What was just decided that the next session must honor without re-litigating. Most recent first. Max 10. One sentence each. Only include what the next session needs to act on — not reasoning or history.
nextAction One sentence. Unambiguous. Include the specific file path, phase number, or artifact name so the next session can act immediately without inferring.
processState The current stage of work and what governs behavior at this stage. Must include a hard rule for what is NOT allowed at this stage. Include a status map when work spans multiple items.
activeConstraints Older rules still in force that predate this session. The constraints a fresh session will most likely violate without knowing them. Max 5. These are persistent background rules, not recent decisions.
What NOT to do
- Do not summarize session history as the handoff
- Do not explain why decisions were made — state them
- Do not include anything the next session does not need to act on
- Do not write prose that lets the next session draw its own conclusions
Progressive disclosure
If the next session needs more context it reads deeper into the file system:
- planner-state.json in full (resumePrompt for audit history)
- the specific PRD phase file being worked on
- CONVENTIONS.md sections relevant to current work
The five fields are the entry point. File reads are how this agent goes deeper — not a database, not a message history, not an external service.
Workflow
- Write all five fields to docs/planner-state.json
- Verify valid JSON:
python3 -c "import json; json.load(open('docs/planner-state.json'))" - Produce copy/paste message using the standard template from planner.md
- The state file is the source of truth — the message points to it
Related Skills
mdmagnuson-creator/verification-contracts
data-ai
VerifiedTrustedCommunity
Generate verification contracts before delegating tasks to sub-agents, defining how success will be measured. Triggers on: verification contract, delegation contract, task verification, contract-first delegation.
SKILL.mdUpdated Apr 21, 2026
mdmagnuson-creator/vercel-supabase-alignment
testing
VerifiedTrustedCommunity
Verify that Vercel environment variables point to the correct Supabase project for each environment to prevent staging/production cross-wiring. Triggers on: vercel supabase check, environment alignment, env var check, supabase environment.
SKILL.mdUpdated Apr 21, 2026
mdmagnuson-creator/vectorize
development
VerifiedTrustedCommunity
Manage codebase and database vectorization for semantic search. Use when initializing, refreshing, or querying the vector index. Triggers on: vectorize init, vectorize refresh, vectorize search, semantic search, vector index, enable vectorization.
SKILL.mdUpdated Apr 21, 2026
mdmagnuson-creator/ui-test-xcuitest
testing
VerifiedTrustedCommunity
Patterns for XCUITest UI tests for native Apple apps (macOS/iOS). Use when writing or reviewing XCUITest tests for Swift apps. Triggers on: XCUITest, xcuitest, native app testing, Apple UI tests, SwiftUI tests, AppKit tests, UIKit tests.
SKILL.mdUpdated Apr 21, 2026