claude-skills/engineering/handoff
Claude 0f88555485
chore(versioning,docs): normalize stale versions to 2.9.0 + refresh counts
Version normalization (scope: only plugins/skills older than 2.7.0):
- Bumped 52 plugin.json + 21 SKILL.md `version` fields from pre-2.7.0
  values (1.0.0 / 2.0.x / 2.2.x / 2.3.x / 2.4.x / 2.5.x) to 2.9.0.
  Left 2.7.0+ packages untouched. Tool mirrors (.codex/.gemini/.vibe/
  .hermes) excluded. All manifests still pass check_plugin_json --all.

Doc count refresh (recomputed raw figures: 338 skills, 16 domains,
62 plugins, 533 Python tools, 676 references):
- marketplace.json: both descriptions + metadata.version -> 2.9.0.
- Root README: headline, badges (Skills 338, Agents 51+, Commands 87+),
  intro counts, convert section (338 skills / 9 tools), and the full
  domain table rebuilt to 16 domains summing to 338 (adds research-ops,
  business-operations, commercial, compliance-os; corrects product 17,
  marketing 46, c-level 66, ra-qm 18, finance 4, engineering 51/78).
- Fixed stale per-skill README `Version:` lines left inconsistent by the
  bump (andreessen, c-level-agents, product-team, senior-qa).
- Fixed stale domain README footers (product-team 17/17, c-level 66/66,
  project-management 9/9).
- CLAUDE.md scope line, structure tree, highlight, and footer synced to
  the raw figures.

https://claude.ai/code/session_01PUNmQVE4WYvcrzpq2anC3D
2026-05-27 05:22:59 +00:00
..
.claude-plugin chore(versioning,docs): normalize stale versions to 2.9.0 + refresh counts 2026-05-27 05:22:59 +00:00
agents feat(productivity): derive caveman + grill-me + handoff from Matt Pocock (MIT) 2026-05-13 21:50:40 +00:00
commands feat(productivity): derive caveman + grill-me + handoff from Matt Pocock (MIT) 2026-05-13 21:50:40 +00:00
skills/handoff fix(productivity): add H1 heading to caveman/grill-me/handoff SKILL.md 2026-05-13 21:54:09 +00:00
README.md feat(productivity): derive caveman + grill-me + handoff from Matt Pocock (MIT) 2026-05-13 21:50:40 +00:00

handoff

Conversation-handoff document generator. Saves the current state of a conversation so a fresh agent can pick up the work cleanly.

Attribution

Derived from Matt Pocock's handoff (MIT). Matt's no-duplication discipline preserved verbatim — handoff docs reference existing artifacts by path/URL, never duplicate them.

What this adds on top of Matt's original

Addition Where Why
3 stdlib Python tools skills/handoff/scripts/ Template generator (tailored to next-session focus), artifact deduplicator (find references that should replace inline content), skill recommender (which skills next session needs)
3 in-depth references (5+ sources each) skills/handoff/references/ Handoff structure · Deduplication discipline · Skill matching for next session
cs-handoff-author persona agent agents/cs-handoff-author.md Continuity-focused handoff author with hard rule against duplication
/cs:handoff slash command commands/cs-handoff.md One-shot handoff generation with argument hint

Matt's original (preserved)

"Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save it to a path produced by mktemp -t handoff-XXXXXX.md (read the file before you write to it). Suggest the skills to be used, if any, by the next session. Do not duplicate content already captured in other artifacts (PRDs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead. If the user passed arguments, treat them as a description of what the next session will focus on and tailor the doc accordingly."

Quick start

# Generate a handoff template scaffold tailored to next-session focus
python skills/handoff/scripts/handoff_template_generator.py --next-focus "ship PR 2"

# Detect artifacts in a handoff draft that could be replaced by references
python skills/handoff/scripts/artifact_deduplicator.py path/to/draft-handoff.md

# Recommend skills for the next session based on handoff content
python skills/handoff/scripts/skill_recommender.py path/to/handoff.md

License

MIT (matching Matt's upstream).