method-handoff skill
Creates and resumes portable continuity records for data science tasks to preserve context between different agents or sessions.
- GitHub stars
- 6
- Files
- 1
- Last commit
- Oct 31, 2026
- License
- MIT
- Allowed tools
- —
What does the method-handoff skill do?
method-handoff creates and resumes portable continuity records for data science tasks to preserve context between different agents or sessions.
Summary generated from the skill's SKILL.md.
About the method-handoff skill
Preserving the state of data science workflows when transitioning between different agents or sessions is the primary function of this tool. It allows developers to generate portable continuity records that capture objective, verified progress without relying on volatile chat histories. When an agent needs to move work to a new environment, it uses the create command to write a markdown file to the docs/handoffs/ directory. This record includes the current branch state, completed tasks, active constraints like SAP and real-data gates, and the next safe action.
To pick up where a previous session left off, an agent uses the resume command with a specific path or keywords. The tool reads the existing record and verifies that the referenced files and branches still exist before summarizing the remaining work. It is designed to maintain safety by explicitly excluding credentials, private model transcripts, or raw patient data. This ensures that the handoff remains a lightweight, human-readable summary of technical state and residual risks rather than a heavy data dump.
What an agent can do with it
- 1Resuming work in a new sessionA developer can instruct an agent to read a previous handoff file to understand the current repository state.
- 2Maintaining safety constraints during handoffsThe tool ensures that critical validation gates and active constraints are carried over to the next session.
Written from the skill's SKILL.md. Every use case is checked against a quote from it.
How to install the method-handoff skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the method-handoff skill in Plugin
/plugin marketplace add sajor2000/methodsmith /plugin install methodsmith@methodsmith
Install the method-handoff skill in Claude Code
~/.claude/skills/method-handoff/SKILL.md
$ npx degit sajor2000/methodsmith/plugins/methodsmith/skills/method-handoff ~/.claude/skills/method-handoffInstall the method-handoff skill in Claude Code (project)
.claude/skills/method-handoff/SKILL.md
$ npx degit sajor2000/methodsmith/plugins/methodsmith/skills/method-handoff .claude/skills/method-handoffInstall the method-handoff skill in Codex
~/.agents/skills/method-handoff/SKILL.md
$ npx degit sajor2000/methodsmith/plugins/methodsmith/skills/method-handoff ~/.agents/skills/method-handoffInstall the method-handoff skill in Gemini CLI
~/.gemini/skills/method-handoff/SKILL.md
$ npx degit sajor2000/methodsmith/plugins/methodsmith/skills/method-handoff ~/.gemini/skills/method-handoffInstall the method-handoff skill in Claude.ai
npx degit sajor2000/methodsmith/plugins/methodsmith/skills/method-handoff method-handoff && zip -r method-handoff.zip method-handoff # claude.ai → Customize → Skills → + → Create skill → Upload a skill → method-handoff.zip
SKILL.md
View on GitHubHandoff
Skill Value
- Problem it solves: Session context disappears while task constraints and verification evidence still matter.
- Use when: Work must move to another agent or later session without relying on chat history.
- Output: A concise, portable handoff record or a verified resume summary.
- Ask only if: The requested continuity source is ambiguous or stale evidence changes the safe next action.
- Do not do: Treat a handoff as authority to mutate code, expose restricted data, or bypass current validation.
Create a durable, human-readable continuity record when work must move to another session or agent. The record preserves objective, verified state, changed files, constraints, commands run, residual risks, and the next safe action; it never includes credentials, raw patient data, or private model transcripts.
Routes
- Bare invocation or
create [focus]: write a handoff underdocs/handoffs/using the current repository state and conversation context. resume <path or keywords>: read the selected handoff, verify referenced paths still exist, and summarize what remains before acting.
Create
Resolve the repository root and choose docs/handoffs/YYYY-MM-DD-<slug>.md. Use repo-relative paths. Include: objective, branch/PR state, completed and verified work, active constraints (including real-data and SAP gates), residuals, and one next action. State uncertainty explicitly. Do not mutate source files, stage, commit, push, or create a PR as part of handoff creation.
Resume
Treat a handoff as context, not authority. Re-check its branch, file, and validation claims before continuing. If its target is missing or its evidence is stale, report the mismatch and ask for direction before any mutation.
Files in this skill
1method-handoff skill questions
How do I install the method-handoff skill in Claude Code?
Run npx degit sajor2000/methodsmith/plugins/methodsmith/skills/method-handoff ~/.claude/skills/method-handoff. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the method-handoff skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.
When should I use the handoff skill?
Use this skill when work needs to move to another agent or a later session without relying on chat history.
What information is included in a handoff record?
The record includes the objective, branch or PR state, completed and verified work, active constraints, residuals, and the next safe action.
Does the handoff record include sensitive information?
No, the record never includes credentials, raw patient data, or private model transcripts.