# Handoff Writer

> 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.

- **Type:** Skill
- **Install:** `agentstack add skill-fengsihao23-eng-shen-hua-handoff-writer`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [fengsihao23-eng](https://agentstack.voostack.com/s/fengsihao23-eng)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [fengsihao23-eng](https://github.com/fengsihao23-eng)
- **Source:** https://github.com/fengsihao23-eng/shen-hua/tree/main/skills/handoff-writer

## Install

```sh
agentstack add skill-fengsihao23-eng-shen-hua-handoff-writer
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

1. Read `.agent/PLAN.md`, `.agent/TASKS.md`, `.agent/LOG.md`, `.agent/DECISIONS.md`, and `.agent/REVIEW_CHECKLIST.md`.
2. Summarize the current objective and phase.
3. List completed work this round.
4. List changed files and their purpose.
5. Record verification commands and results.
6. Record decisions and residual risks.
7. Write the exact next action for a future agent.
8. 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

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

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [fengsihao23-eng](https://github.com/fengsihao23-eng)
- **Source:** [fengsihao23-eng/shen-hua](https://github.com/fengsihao23-eng/shen-hua)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-fengsihao23-eng-shen-hua-handoff-writer
- Seller: https://agentstack.voostack.com/s/fengsihao23-eng
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.