shift-change
Skill10 starsChanged 8 days agoMITView on GitHub
Hand a dkitchen role over to a fresh session. Run it in the outgoing session to write the handover note, then in the incoming session with "take over <note>" to pick up from it.
In this repository10 other files it gives its agents.
- AGENTS.mdAGENTS.md
- build-nightSkill
- build-repoSkill
- build-runnerSkill
- build-teamSkill
- goodmorningSkill
- goodnightSkill
- improve-kitchenSkill
- setup-dkitchenSkill
- write-ticketSkill
The file
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 0 are distinctive, and 4 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 12
Run without an argument, or with what the next shift should focus on, to hand over.
- Very specific: line 38
Write it to /tmp/dkitchen-handoff/<repo name>/<role>-<UTC time>.md, outside the repo.
- Very specific: line 51
Stop your watch, since only one watch runs per state file and the incoming session must start its own.
- Very specific: line 58
Sign in: put your session name in your role's row of the Current sessions table in docs/agents/roles.md, the way this repo changes its …
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Shift change
A role's session gets replaced when its context fills up or the user wants a fresh one. The outgoing chef writes a handover note and leaves the role in order; the incoming chef takes over from the note and the sources it points to.
Run without an argument, or with what the next shift should focus on, to hand over. Run with take over <note path> to take over.
An executor does not use this skill: its ticket already holds the whole story, and a new executor takes the ticket with ding new --issue <ticket> --replace.
Handing over
1. Gather
From the sources, not from memory:
- your role, from the Current sessions table in
docs/agents/roles.md, and the peers' session names; ding board, and the open tickets you own or that wait on you (gh issue list, thestatus:*labels);- your watch's command and state file, your other background tasks, and jobs you started;
- open night orders:
ding night show; - decisions the user made in this conversation, and instructions the user gave you here that no file records.
Done when you can name every open ticket that needs your role, everything you have running, and every user decision from this conversation.
2. Put on the tickets what belongs there
A user decision given only in this conversation goes on its ticket now, verbatim, as the Asking the user section of docs/agents/roles.md says. The note then links to it rather than carrying it.
Done when every user decision from step 1 is on a ticket or listed for the note's own section below.
3. Write the note
Write it to /tmp/dkitchen-handoff/<repo name>/<role>-<UTC time>.md, outside the repo. Link to what tickets, commits, and docs already hold rather than copying it, and leave out secrets such as keys and passwords. The note holds:
- Role: the role, the repo, and the focus the user gave, if any.
- Peers: each peer role's session name and how to message it.
- Open work: one line per ticket: its link, its state, the next step, and who takes it.
- Running: the watch command, background tasks, and jobs, each with how to check it.
- Night orders: the link to open orders, or "none".
- Not yet in the rules: standing instructions the user gave in this conversation, verbatim with their date. Suggest that the user make them rules, for example with
/improve-kitchen. - Watch out: what you learned the hard way that no file records.
- Skills: the skills the next shift should load.
4. Leave the role
Stop your watch, since only one watch runs per state file and the incoming session must start its own. Then give the user the note's path and one line: open a new session and run /shift-change take over <path> in it.
Done when the note exists, your watch is stopped, and the user has the path.
Taking over
- Read the note, then
docs/agents/roles.mdand the files it points to for your role. The note is a snapshot: before acting on a ticket it lists, read that ticket's latest comments. - Sign in: put your session name in your role's row of the Current sessions table in
docs/agents/roles.md, the way this repo changes its rules. Tell each peer role your session name in one line. - Start your watch as
docs/agents/watch.mdsays, and checkding night show. - Pick up the open work in the note's order, each ticket from its latest comment.
Done when the table names your session, your watch runs, and you have read the latest state of every ticket the note lists.
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
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.

