Handoff Skill

Handoff Skill creates a durable state packet for coding agents. It captures what is true now, what changed, what was verified, and the exact plan a later agent should follow.

• Public repo: https://github.com/cskwork/handoff-skill
• Landing page: https://cskwork.github.io/handoff-skill/

• Stop a task without losing implementation state.
• Resume work in a fresh session.
• Transfer a task to another coding agent.
• Give QA or review agents a precise continuation brief.
• Preserve decisions, rejected options, and verification evidence.

From this repository:

./install.sh

Manual install:

mkdir -p "$HOME/.agents/skills/handoff"
cp skills/handoff/SKILL.md "$HOME/.agents/skills/handoff/SKILL.md"

npm test

The test validates the skill metadata, required workflow sections, handoff template coverage, and text hygiene.

If you have the global skill-creator scripts installed:

python -m scripts.package_skill "$(pwd)/skill"

A good handoff packet includes:

• Goal and latest request.
• Current workspace, branch, running sessions, and artifacts.
• Completed work with evidence.
• Decisions and rejected options.
• Files changed and untouched relevant files.
• Remaining implementation plan with completion criteria.
• Verification plan.
• Risks, assumptions, suggested skills, resume prompt, and redactions.

The landing page lives in docs/. Enable GitHub Pages with source main and folder /docs.

Edit skills/ only. The existing Cursor package is a generated distribution:

python3 scripts/sync-cursor.py
python3 scripts/sync-cursor.py --check

Keep generated files committed so direct Cursor installation remains self-contained.