reset · orwa-mahmoud — Claude Code skill: runtime cleanup and installation
The reset Claude Code skill clears damaged or confusing runtime state in an open project. It removes temporary markers and the deadline while preserving work and evidence.
MIT ★ 571 updated 2026-11-16
npx skills add orwa-mahmoud/nightshift --skill reset -a claude-codeWhat reset does
The skill resets runtime mechanics in the open project after a damaged or confusing state. Its reset-shift helper pauses and disarms the shift, then removes the current deadline and temporary session, recovery, watchman, lease, and mutex markers.
The punch list, unfinished items, rules, archives, logs, and workspace settings stay intact. The .nightshift/ directory and plugin installation are preserved too. Running Reset again is safe.
Commands must go through the trusted runtime/ns helper; runtime files should not be deleted by hand. A new deadline is added after Reset only when Hunt, a work order, or the project owner provides one.
What it helps with
- clear damaged runtime state in an open project
- remove leftover session and mutex markers
- remove the current deadline without losing unfinished work
- preserve project history and settings during a reset
Example prompts for the agent
- Reset the runtime state in the open project.
- Remove the current deadline and temporary markers while keeping project files.
- Clear the damaged runtime state using the trusted helper.
How to install reset
1Skills CLI (Vercel)
npx skills add orwa-mahmoud/nightshift --skill reset -a claude-code2Manually: put the files in place
~/.claude/skills/reset/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/reset/
1Skills CLI (Vercel)
npx skills add orwa-mahmoud/nightshift --skill reset -a codex2Manually: put the files in place
.agents/skills/reset/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add orwa-mahmoud/nightshift --skill reset -a cursor2Manually: put the files in place
.cursor/skills/reset/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install orwa-mahmoud/nightshift plugins/nightshift/skills/reset2Manually: put the files in place
.github/skills/reset/SKILL.md1Skills CLI (Vercel)
npx skills add orwa-mahmoud/nightshift --skill reset -a gemini-cli2Platform CLI
gemini skills install https://github.com/orwa-mahmoud/nightshift --path plugins/nightshift/skills/resetManually: put the files in place
.devin/skills/reset/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add orwa-mahmoud/nightshift --skill reset -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about reset
How do I install reset in Claude Code?
Run npx skills add orwa-mahmoud/nightshift --skill reset -a claude-code. The skill file is located at ~/.claude/skills/reset/SKILL.md.
What does reset do?
It removes the current deadline and temporary runtime markers while keeping the punch list, history, rules, and workspace settings. It leaves .nightshift/ and the plugin installation intact.
What does reset preserve?
Unfinished items, work orders, receipts, archives, logs, and workspace configuration remain in place. Running the reset again is safe.
Source text
SKILL.md · MIT
---
name: reset
description: Drop the runtime markers and deadline after damaged or confusing runtime state, without deleting the owner's work or evidence.
license: MIT
metadata:
internal: true
---
Reset runtime mechanics for the host-opened project. This recovers from damaged or confusing
runtime state. It does not delete the punch list, rules, history, or `.nightshift/` itself.
Resolve the installed plugin root to an absolute `$NIGHTSHIFT_PLUGIN_ROOT` — `${CLAUDE_PLUGIN_ROOT}`
on Claude Code, `$PLUGIN_ROOT` on Codex when set, otherwise the absolute path this skill was
attached from (`skills/reset/SKILL.md`). Run every command below through
`"$NIGHTSHIFT_PLUGIN_ROOT/runtime/ns"` — native Windows: `& "$NIGHTSHIFT_PLUGIN_ROOT\runtime\windows\ns.ps1"`
in the PowerShell tool, same verbs — which resolves the host and the workspace; `ns help` lists the
verbs, and `ns bind` prints the six resolved facts (`TASK_ROOT`, `NIGHTSHIFT_WORKSPACE`, `NS`,
`NIGHTSHIFT_PLUGIN_ROOT`, `HOST`, `SOURCE`); `$NS` below is that `NS`. Never a bare relative path: the working
directory persists between calls. Each `$NS/...` path below is where the current layout keeps that file;
`ns path <key>` prints where this workspace keeps it, and `ns path --list` names every key.
Run the trusted helper. Do not delete runtime files by hand:
```bash
"$NIGHTSHIFT_PLUGIN_ROOT/runtime/ns" reset-shift
```
The helper first performs Stop (pause and disarm), then removes the current deadline, leftover
`STOP`, and temporary session, recovery, watchman, lease, and mutex markers. It preserves the punch
list and unfinished items, rules, parking lot, work orders, receipts, archives, research,
opportunities, snag log, shift log, and workspace configuration such as work-target and work-mode.
A second Reset is safe. It never deletes `.nightshift/`.
Report that the deadline was removed and that durable files remain. The plugin install is
untouched. Start after Reset writes a new deadline only when Hunt, a work order, or the owner
supplies one — it does not invent a time budget.
© orwa-mahmoud · MIT · orwa-mahmoud/nightshift
Similar skills
All skills for Agent setup: memory, context, orchestration →reset by other authors comes first.