zz-handover

Converts a closed initiative's documents and telemetry into gated knowledge nodes and a handover document.

Updated Sep 11, 2026
One-click install
npx skills add https://github.com/zhixuan312/zz-stack --skill zz-handover-zhixuan312
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: zz-handover
Source: https://github.com/zhixuan312/zz-stack/tree/main/marketplace/zz-core/skills/zz-handover
Command: npx skills add https://github.com/zhixuan312/zz-stack --skill zz-handover-zhixuan312

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a delivery initiative closes, its lessons disappear unless someone deliberately extracts them. This Skill reads one closed initiative end to end — its documents, activity telemetry, recorded claims, and ledger row — decides which findings generalise beyond the team, mints platform-scoped knowledge nodes immediately, and proposes team-scoped nodes in a single gated handover document that a person must approve. ## Core Features & Use Cases - Telemetry computation: Mechanically derives end-to-end time, stage timings, question load, effort shape, rework signals, and post-acceptance noise from activity.jsonl before any judgement is made. - Two-shelf knowledge routing: Decides for each finding whether it is a fact about a registry entry (minted immediately with knowledge_add(scope: "platform")) or a fact about this team (proposed in handover.md and minted only after approval). - Two-pass gated workflow: Pass 1 writes the three-section handover.md with a machine-readable proposed_team_nodes count; Pass 2 mints exactly the approved team nodes, with a narrow exception for facts that became false between approval and minting. - Use Case: After an SDLC initiative closes with an outcome recorded in _ledger.md, run this Skill to produce an approvable handover that records plugin defects and refusal classes for every team while proposing stakeholder-specific conduct patterns for this team's own shelf. ## Quick Start Run the zz-handover skill on the closed initiative to compute its telemetry, mint platform knowledge nodes, and write its gated handover document.

Frequently Asked Questions about zz-handover

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a handover after an initiative closes?▼

Run the handover skill once the closing document carries an outcome and the platform has appended the initiative's row to _ledger.md. It reads all declared documents, activity.jsonl, and knowledge_reconcile output, then writes a gated handover.md for a person to approve.

What is the difference between platform-scoped and team-scoped knowledge nodes?▼

Platform-scoped nodes record facts about registry entries such as plugins, flows, or providers and are minted immediately with knowledge_add. Team-scoped nodes describe this team's stakeholder, systems, or history and are minted only after handover.md naming them is approved.

When does the handover skill mint team knowledge nodes?▼

Team nodes are minted only in Pass 2, after handover.md exists and is approved. Pass 2 transcribes exactly the approved lines under 'Proposed for the team', with a narrow exception for factual assertions verified to have become false since approval.

Can the handover run during active delivery?▼

No. It runs strictly after close and the stakeholder never sees the run. If handover.md exists but is still draft or awaiting approval, the skill does nothing because the gate belongs to a human reviewer.

What happens if a handover section has no findings?▼

Zero is a correct, approvable outcome. The skill writes one line stating nothing was recorded and why, rather than padding the section, and still declares proposed_team_nodes as "0" in the document_write fields.