Y
YourAKShaw/handoff
An agent skill that saves and resumes your work in one HANDOFF.md, so Claude Code, Codex, Gemini CLI or any…
View on GitHub ↗Link checked 2026-11-12 · HTTP 200 · opens the vendor's own site
Install & config
Client config (built from the install command this repo gives)
{
"mcpServers": {
"yourakshaw-handoff": {
"command": "npx",
"args": ["skills"]
}
}
}Parsed from the README we fetched on 2026-11-03; we have not executed it.
command/args come from the install command the repository states. When it is ambiguous, the project README wins.
VS Code (.vscode/mcp.json - the key is servers)
{
"servers": {
"yourakshaw-handoff": {
"command": "npx",
"args": ["skills"]
}
}
}Same server, but VS Code keeps it under <code>servers</code>.
Claude Code (command line)
claude mcp add --transport stdio yourakshaw-handoff -- npx skills
Claude Code does not read a config file; add the server with this command.
Key names differ by client: Clients & CLI
- Star count
- 0 ★ · YourAKShaw/handoff · read from the GitHub search API · (checked 2026-11-13 20:00:50)
- Source
- read directly from its GitHub page · type: open-source project
- Harvest history
- first seen 2026-11-04 · last seen 2026-11-14 · seen 11× · listed by 1 sources
- Score
- score 103 · 1 sources · repo
- Install
npx skills
FAQ (answers come from our records)
How do I install it?
The repository provides this install command:
npx skills. It comes from the repository itself; we cannot guarantee it runs as-is in your client.Who is it for?
We filed it under these tags: Agent 技能. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
YourAKShaw/handoff；first catalogued 2026-11-04；last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.# 🔁 Handoff
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
Pick up every AI coding session exactly where the last one stopped — with any agent.
One small file carries the goal, the state, and the next steps from session to session.
Explore the skill · Handoff format · Contribute · Get help · Security
## Every new session starts from zero
Close a session and the context goes with it. The next one — tomorrow, in another agent, or after the credits run out — has to rediscover the goal, re-read the repository, and re-learn the constraints you already stated: the branch never to touch, the design that must not change, the command that only works with a special flag. Work gets repeated, and decisions get quietly reversed.
Handoff is an agent skill that fixes this with one file, HANDOFF.md, at the root of your repository. At the end of a session the agent rewrites it; at the start of the next, any agent reads it first and continues from the first open step. It works the same in Claude Code, Codex, Gemini CLI, Antigravity, Grok, or any agent that can read a Markdown file.
> Hold only what the next session needs, point to everything else, and never carry secrets.
## ⚙️ What the skill brings to your agent
| Capability | What it means in practice |
| Instant continuation | A new session reads one short file and starts the first next step, without re-reading the whole repository. |
| Constraints that stick | Decisions and standing rules you gave in one session are recorded, so the next agent keeps them. |
| Agent-neutral | Plain Markdown at the repository root, plus a rule for AGENTS.md, CLAUDE.md or GEMINI.md. No lock-in to one tool. |
| Always current | The file is rewritten, never appended. Finished work drops out; the length stays under about 80 lines. |
| Safe by default | Secrets, tokens, one-time codes and personal data are never recorded. |
| Version-controlled | The handoff is committed with the work when commits are allowed, so its history travels with the repository. |
## 🧩 How it works
mermaid
flowchart LR
A[Session ends] -->|"handoff" or /handoff| B[Agent rewrites HANDOFF.md]
B --> C[(HANDOFF.md in the repo)]
C --> D[New session, any agent]
D -->|reads first| E[Continues from Next steps]
E --> A
HANDOFF.md always has the same five sections, defined in the handoff format:
| Section | Holds |
| Goal right now | The current aim and the standing constraints. |
| Where things stand | Branch, what is finished, the last checks actually run. |
| Next steps | A numbered list, each naming the file or command to start from. |
| Open questions | Decisions waiting on someone. |
| Gotchas | Traps a fresh session would otherwise hit. |
## Three workflows
| Workflow | When | Result |
| Save a handoff | End of a session, when you ask | HANDOFF.md rewritten and committed when allowed |
| Resume a handoff | Start of a session | Work continues from the first open step |
| Bootstrap a repository | A repository without a handoff | HANDOFF.md plus a rule in its agent instructions |
## 📥 Get started
Keep SKILL.md, references/, workflows/, assets/ and scripts/ together so the skill can find its resources.
### Install once for every agent
Clone one shared copy and link it into each agent. Full details, including where each agent looks, are in agent setup.
One small file carries the goal, the state, and the next steps from session to session.
Explore the skill · Handoff format · Contribute · Get help · Security
## Every new session starts from zero
Close a session and the context goes with it. The next one — tomorrow, in another agent, or after the credits run out — has to rediscover the goal, re-read the repository, and re-learn the constraints you already stated: the branch never to touch, the design that must not change, the command that only works with a special flag. Work gets repeated, and decisions get quietly reversed.
Handoff is an agent skill that fixes this with one file, HANDOFF.md, at the root of your repository. At the end of a session the agent rewrites it; at the start of the next, any agent reads it first and continues from the first open step. It works the same in Claude Code, Codex, Gemini CLI, Antigravity, Grok, or any agent that can read a Markdown file.
> Hold only what the next session needs, point to everything else, and never carry secrets.
## ⚙️ What the skill brings to your agent
| Capability | What it means in practice |
| Instant continuation | A new session reads one short file and starts the first next step, without re-reading the whole repository. |
| Constraints that stick | Decisions and standing rules you gave in one session are recorded, so the next agent keeps them. |
| Agent-neutral | Plain Markdown at the repository root, plus a rule for AGENTS.md, CLAUDE.md or GEMINI.md. No lock-in to one tool. |
| Always current | The file is rewritten, never appended. Finished work drops out; the length stays under about 80 lines. |
| Safe by default | Secrets, tokens, one-time codes and personal data are never recorded. |
| Version-controlled | The handoff is committed with the work when commits are allowed, so its history travels with the repository. |
## 🧩 How it works
mermaid
flowchart LR
A[Session ends] -->|"handoff" or /handoff| B[Agent rewrites HANDOFF.md]
B --> C[(HANDOFF.md in the repo)]
C --> D[New session, any agent]
D -->|reads first| E[Continues from Next steps]
E --> A
HANDOFF.md always has the same five sections, defined in the handoff format:
| Section | Holds |
| Goal right now | The current aim and the standing constraints. |
| Where things stand | Branch, what is finished, the last checks actually run. |
| Next steps | A numbered list, each naming the file or command to start from. |
| Open questions | Decisions waiting on someone. |
| Gotchas | Traps a fresh session would otherwise hit. |
## Three workflows
| Workflow | When | Result |
| Save a handoff | End of a session, when you ask | HANDOFF.md rewritten and committed when allowed |
| Resume a handoff | Start of a session | Work continues from the first open step |
| Bootstrap a repository | A repository without a handoff | HANDOFF.md plus a rule in its agent instructions |
## 📥 Get started
Keep SKILL.md, references/, workflows/, assets/ and scripts/ together so the skill can find its resources.
### Install once for every agent
Clone one shared copy and link it into each agent. Full details, including where each agent looks, are in agent setup.
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/yourakshaw-handoff/)
- Source
- github · https://github.com/YourAKShaw/handoff
- Browse by field
- Agent skills
- added
- today
More like this
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.