Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add orwa-mahmoud/nightshift --skill reset -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/reset/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/reset/

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.

From the same set17

The whole set →
status status — a skill for Claude Code reports the current shift state in a project. It runs read-only checks and starts no work. CX Codex +1 ★ 571repo stars start This Claude Code skill starts a Nightshift run from the project's punch list. When the list is empty, it presents staged work for selection. CX Codex +1 ★ 571repo stars setup The setup Claude Code skill prepares Nightshift in a project and proposes quality checks through at most four questions. It creates .nightshift/ without enabling checks on its own. CX Codex +1 ★ 571repo stars schedule Prints scheduler configuration for starting a shift at a set time. It checks the Nightshift workspace and queued work before generating it. CX Codex +1 ★ 571repo stars quality This Claude Code skill groups project quality work into a single shift. It starts on requests about tests, accessibility, documentation, contracts, or security. CX Codex +1 ★ 571repo stars purge The purge Claude Code skill deletes Nightshift state from a project. It prints the .nightshift/ path and waits for the owner to confirm before deletion. CX Codex +1 ★ 571repo stars plan This Claude Code skill opens a planning room to explore a project and shape the work with its owner. Implementation waits until the owner deliberately leaves the room. CX Codex +1 ★ 571repo stars plan-exit The plan-exit Claude Code skill checks whether plan mode is closed and names the next step toward implementation. It reads the room status and staged items. CX Codex +1 ★ 571repo stars

Project sponsors

Companies that keep this analytics open