agentleFS
voyager67voyager67/AgentFieldkit/skills/context-handoff/SKILL.md

context-handoff

Skill0 starsChanged 13 days agoMITView on GitHub

Create a reliable handoff note so another engineer or coding agent can continue work without redoing exploration. Use before switching sessions, handing off a long task, or pausing midway.

13 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use systematic-debugging.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • OpenAISkill

    systematic-debugging

    Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

4 rules. 0 are common, 4 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 11 edited versions we read keep these.

  • 4

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Keep it short enough to rehydrate quickly.

    line 16
  2. Distinctive:

    Never claim work was saved or committed if it was not.

    line 28
  3. Distinctive:

    Never include credentials, tokens, private user data, or unnecessary personal information in the handoff.

    line 29
  4. Distinctive:

    If repository state changed outside the agent's knowledge, tell the next agent to inspect status before editing.

    line 30

“Common” is measured: kept by at least 6 in 10 of the 11 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Context Handoff

Procedure

  1. Summarize the user's goal and the acceptance criteria; keep requirements separate from assumptions.
  2. Record the current repository and branch, relevant files, important symbols, current diff status, and any uncommitted user work.
  3. List commands run and exact outcomes. Clearly distinguish tested facts, inferred explanations, and open hypotheses.
  4. Note decisions made and alternatives rejected with brief reasons. Include links or paths to source evidence where possible.
  5. Describe remaining work in a prioritized order, with a concrete next action rather than generic reminders.
  6. Record safety boundaries: files/data not to modify, external actions not yet authorized, secrets to avoid, and any concurrent work or shared resource constraints.
  7. Keep it short enough to rehydrate quickly; link detailed logs instead of pasting them.

Template

  • Goal / acceptance criteria
  • Current state
  • Files and key decisions
  • Verification performed
  • Remaining work (ordered)
  • Risks / unknowns
  • Safe next command or action

Boundaries

  • Never claim work was saved or committed if it was not.
  • Never include credentials, tokens, private user data, or unnecessary personal information in the handoff.
  • If repository state changed outside the agent's knowledge, tell the next agent to inspect status before editing.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.