Skip to main content
NEW · APP STORE Now on iOS · macOS · iPad Android & Windows soon GET IT
Prompts Agent Conversation Handoff Document Writer

agent workflow skill risk: medium

Agent Conversation Handoff Document Writer

Instructs the model to write a handoff document summarizing the current conversation for another agent, save it to a path from mktemp -t handoff-XXXXXX.md after reading the file, s…

  • External action: medium

SKILL 1 file

SKILL.md
---
name: handoff
description: "Compact the current conversation into a handoff document for another agent to pick up."
---
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.

REQUIRED CONTEXT

  • current conversation

OPTIONAL CONTEXT

  • user arguments describing next session focus

TOOLS REQUIRED

  • code_execution

ROLES & RULES

  1. Write a handoff document summarising the current conversation so a fresh agent can continue the work.
  2. Save it to a path produced by `mktemp -t handoff-XXXXXX.md` (read the file before you write to it).
  3. Suggest the skills to be used, if any, by the next session.
  4. Do not duplicate content already captured in other artifacts (PRDs, plans, ADRs, issues, commits, diffs).
  5. Reference them by path or URL instead.
  6. If the user passed arguments, treat them as a description of what the next session will focus on and tailor the doc accordingly.

EXPECTED OUTPUT

Format
markdown
Constraints
  • save to path from mktemp -t handoff-XXXXXX.md after reading it
  • suggest skills for next session
  • reference other artifacts by path/URL instead of duplicating
  • tailor based on any user-provided arguments describing next focus

SUCCESS CRITERIA

  • Summarise the current conversation
  • Suggest skills for the next session
  • Avoid duplicating content already captured in other artifacts

CAVEATS

Dependencies
  • current conversation
  • user arguments if passed
Missing context
  • Definition or scope of 'skills'
  • Exact list or examples of artifacts to avoid duplicating
Ambiguities
  • Why read the file before writing to a path produced by mktemp (new file).
  • 'skills' is undefined and not exemplified.

QUALITY

OVERALL
0.78
CLARITY
0.80
SPECIFICITY
0.75
REUSABILITY
0.85
COMPLETENESS
0.70

IMPROVEMENT SUGGESTIONS

  • Replace 'read the file before you write to it' with a clear rationale or remove the step.
  • Add a brief definition or examples of what 'skills' means in this context.

USAGE

Copy the prompt above and paste it into your AI of choice — Claude, ChatGPT, Gemini, or anywhere else you're working. Replace any placeholder sections with your own context, then ask for the output.

MORE FOR AGENT