Handoff writer

Skill fengsihao23-eng/shen-hua/skills/handoff-writer

A Codex skill pack for long-running project work

Install

npx -y skills add fengsihao23-eng/shen-hua --skill handoff-writer

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Shen-Hua handoff writer for ending or pausing long-running Codex work. Use at the end of every project work round, before final responses, after interruptions, when switching agents/sessions, or whenever the next Codex instance needs a concise resume point with completed work, changed files, verification, risks, and next actions.

SKILL.md

2.3 KB, as published. Nobody here has run it

Handoff Writer

Handoff Writer leaves the next agent with a reliable resume point.

Trigger Conditions

Use this skill when:

A response is about to end after project work.
Work is paused, blocked, or handed to another agent/session.
The user asks for status, summary, continuation notes, or "where are we".
$project-commander finishes a round.

Do Not Trigger

Do not use this skill for:

One-line answers with no project state.
Work that explicitly must leave no project memory.

Handoff Workflow

Read .agent/PLAN.md, .agent/TASKS.md, .agent/LOG.md, .agent/DECISIONS.md, and .agent/REVIEW_CHECKLIST.md.
Summarize the current objective and phase.
List completed work this round.
List changed files and their purpose.
Record verification commands and results.
Record decisions and residual risks.
Write the exact next action for a future agent.
Update task statuses so the next agent does not have to infer them.

Required `.agent/` Updates

Always update:

.agent/HANDOFF.md: full current handoff.
.agent/LOG.md: handoff written with summary.
.agent/TASKS.md: next action and statuses.

Update when relevant:

.agent/PLAN.md: current phase if changed.
.agent/DECISIONS.md: final decisions not yet recorded.

Other Skills

Use $self-reviewer before handoff when changes were made.
Use $verification-loop first if no verification status exists and the task involved code/config changes.

Subagents

Do not launch new subagents only to write a handoff. If subagents are active or recently completed, include their status and outputs.

Verification Commands

Handoff Writer does not normally run commands. It records the latest verification state and flags stale or missing verification.

Output Format

HANDOFF
Objective:
Current phase:
Completed:
Changed files:
Verification:
Decisions:
Open risks/blockers:
Next action:
Resume prompt: