purge

purge is a skill for Claude Code from orwa-mahmoud/nightshift. It costs 19 tokens per session (476 once invoked), scanned A, original, MIT.

A cleanup command that permanently removes Nightshift data from a project. Nightshift is a system for tracking coding tasks, decisions, rules, receipts, archives, and history.

In plain words
What is it for?
Use it when Nightshift should be removed from one project, including its punch lists, rules, receipts, archives, and history.
Why use it?
It clears the project’s Nightshift records while leaving the globally installed plugin in place. Because the deletion is permanent, the project state cannot be recovered through Nightshift afterward.

Skill for Claude Code

Written for Claude Code: ${CLAUDE_PLUGIN_ROOT} variable. Also seen: mentions Claude Code; mentions Codex.

Runs only inside its plugin — its command needs a path that Claude Code sets for a plugin’s own hooks and for nothing else. Install the plugin, not this.

Part of the nightshift plugin — 13 skills, 5 hooks shipped together

Good fit Use it when Nightshift should be removed from one project, including its punch lists, rules, receipts, archives, and history.

Compare 6 skills from other repositories ↓
Install

Getting it into your agent

This one installs as part of its plugin. Adding the marketplace and installing the plugin brings it with everything else the plugin ships.

Claude Code
/plugin marketplace add orwa-mahmoud/nightshift
Claude Code
/plugin install nightshift

Made for: Claude Code.

Or install nightshift, the plugin that ships this one along with the rest of its 13 skills, 5 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for purge

README.md
[![agentmods](https://agentmods.dev/badge/skills/orwa-mahmoud/nightshift/purge/github.svg)](https://agentmods.dev/skills/orwa-mahmoud/nightshift/purge)
Your own site
<a href="https://agentmods.dev/skills/orwa-mahmoud/nightshift/purge"><img src="https://agentmods.dev/badge/skills/orwa-mahmoud/nightshift/purge/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for purge

Your own site · 80×15
<a href="https://agentmods.dev/skills/orwa-mahmoud/nightshift/purge"><img src="https://agentmods.dev/badge/skills/orwa-mahmoud/nightshift/purge.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 19 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 476 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00019 $0.00476
Opus 5 $0.00010 $0.00238
Sonnet 5 $0.00004 $0.00095
Haiku 4.5 $0.00002 $0.00048

Measured 2d ago against content hash d0582aabe361, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

purge scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/nightshift/skills/purge/SKILL.md · 38 lines

What it actually says

Remove Nightshift from this project. This deletes punch lists, rules, receipts, archives, and history under the project's .nightshift/ directory. It does not uninstall the global Nightshift plugin.

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/purge/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.

Print the exact canonical $NS path. Warn that punch lists, rules, receipts, archives, and history will be lost, and that the plugin itself stays installed. Do not run the helper until the owner confirms that exact path. Then:

"$NIGHTSHIFT_PLUGIN_ROOT/runtime/ns" purge-workspace \
  --confirm-path "$NS"

The helper first performs Reset, then deletes only that validated .nightshift/ directory and a local .nightshift-link on the opened task root when present. It refuses symlinks, malformed links, workspace roots, home directories, /, and other broad paths. It never deletes repository files outside that Nightshift state. A second Purge with the same confirmation is safe.

If the task root is linked, pass the folder you opened as --project "$TASK_ROOT". This is the one command whose target is the task root rather than the workspace, so it is the one place the dispatcher's answer is not the one you want: purging only the workspace path leaves the host link in place.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago Changed · -16 lines d0582aabe361
  2. 4d ago Changed · -4 lines 2c96c159474d
  3. 10d ago First seen · 58 lines · 19 tokens per session scan A 68464993dd44

Subscribe to this mod's changes

purge is a skill published in the GitHub repository orwa-mahmoud/nightshift (58 stars, last pushed today), licensed MIT. It adds 19 tokens to every session and 476 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

hive.chart-creation-foundations

Required reading whenever any chart tool is available. Teaches the one-tool embedding contract (call chartrender → live chart appears in chat AND a downloadable PNG lands in the queen session dir), the ECharts (data viz) vs Mermaid (structural diagrams) decision, the BI/financial-grade aesthetic baseline (no…

aden-hive/hive · 133 tokens

browser-edge-cases

SOP for debugging browser automation failures on complex websites. Use when browser tools fail on specific sites like LinkedIn, Twitter/X, SPAs, or sites with Shadow DOM.

aden-hive/hive · 40 tokens

article-writer

Multi-style article creation skill. Supports 5 writing styles (deep analysis, practical guide, story-driven, opinion, news brief), including complete workflow: material collection → outline → content → formatting. Activated when users mention "write article", "write post", "create", or "draft".

netease-youdao/LobsterAI · 62 tokens

skin-creator

Create and apply a two-asset LobsterAI visual skin from the user's style description. Use only when the AI Skin Designer kit supplies the structured skinpack workflow marker; do not use for ordinary theme or image requests.

netease-youdao/LobsterAI · 48 tokens

weather

Get current weather and forecasts (no API key required).

netease-youdao/LobsterAI · 13 tokens

hive.note-taking

Maintain a free-form scratchpad of decisions, extracted values, and open questions so context pruning doesn't lose anything you still need.

aden-hive/hive · 30 tokens