claude-skills/engineering/handoff
Claude 7405298b4b
fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885)
- #954: strip non-spec source/attribution keys from all 39 plugin.json
  manifests so Claude Code's validator accepts them; metadata preserved in
  new .claude-plugin/authoring-notes.json sidecars; check_plugin_json.py now
  hard-fails manifests carrying those keys and sanity-checks the sidecar;
  CLAUDE.md ClawHub schema section updated to the new rule.
- #949: move the c-level-agents plugin out of c-level-advisor/ to a
  top-level directory so the two marketplace sources no longer overlap;
  updated marketplace.json source, homepage, descriptions, all
  cross-references, docs, harness manifest, mirror-tree symlinks/indexes,
  and rebased the moved files' relative links; domain counters trued up
  (18 -> 19 domains).
- #933: replace dead links to the gitignored maintainer-local megaprompts/
  tree with annotated plain-text references (44 files: SKILL.md, READMEs,
  agents, commands).
- #931: DynamoDB on-demand pricing updated to post-Nov-2024 rates
  ($0.625/M writes, $0.125/M strongly consistent reads).
- #969: skill_security_auditor.py and the three dossier scripts reconfigure
  stdout/stderr to UTF-8 (errors=replace) so legacy Windows codepages no
  longer crash at print time; PYTHONUTF8=1 documented.
- #968: Windows Notes section in INSTALLATION.md + README pointer for the
  core.symlinks mirror-tree checkout caveat.
- #924/#885 residuals: hook commands quote "${CLAUDE_PLUGIN_ROOT}" paths in
  all plugin hooks.json/settings.json (space-safe roots); removed the stale
  pre-rename status/review mirror symlinks and index entries left over from
  the memory-status/memory-review rename.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Qgc6RYXWJPr5oW9DHU7zR4
2026-08-21 05:47:37 +00:00
..
.claude-plugin fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885) 2026-08-21 05:47:37 +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).