lumi-reset

Deletes wiki, raw, or state files with dry-run plans and explicit confirmation.

Updated Jun 3, 2026
One-click install
npx skills add https://github.com/MathematicGuy/team-006-vin20k --skill lumi-reset-mathematicguy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lumi-reset
Source: https://github.com/MathematicGuy/team-006-vin20k/tree/main/lumina-wiki/.agents/skills/lumi-reset
Command: npx skills add https://github.com/MathematicGuy/team-006-vin20k --skill lumi-reset-mathematicguy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Bulk-deleting wiki pages, raw sources, or ingest state is irreversible and error-prone when done ad hoc. This Skill enforces a plan-before-execute workflow so destructive resets are visible, scoped, and confirmed before any file is removed. ## Core Features & Use Cases - Scoped Resets: Five deletion scopes (wiki, raw, state, checkpoints, all) target exactly the right directories, from a single stuck ingest checkpoint to a full wiki wipe. - Mandatory Dry-Run: Always shows the exact list of files to be deleted before execution, and requires the literal word "yes" in chat before running the destructive command. - Path-Safety Enforcement: Delegates deletion to reset.mjs, which refuses path traversal and absolute paths outside the project root. - Use Case: An ingest job for a PDF got stuck halfway. Run the checkpoints scope to clear only the in-progress state file, then restart the ingest cleanly without touching any wiki content. ## Quick Start Ask the assistant to reset the wiki with a dry-run first, for example: "Show me what a wiki-scope reset would delete, then reset it after I confirm."

Frequently Asked Questions about lumi-reset

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely delete all wiki pages before rebuilding?▼

Run the reset with the wiki scope, which first prints a dry-run plan listing every file under wiki/ that would be deleted. Execution only happens after you type the literal word yes in chat, and the script enforces path-safety checks.

How to restart a stuck ingest job without losing wiki content?▼

Use the checkpoints scope, the lowest-risk reset, which deletes only the in-progress ingest state files under _lumina/_state/. Wiki pages and raw sources remain untouched, and you can re-run the ingest immediately afterward.

What is the difference between the all scope and the raw scope?▼

The all scope deletes wiki/ and state files but leaves raw/ untouched. The raw scope deletes user-owned sources under raw/sources/, raw/notes/, and raw/assets/, which are not recoverable from the wiki and may not be in git.

Why does the reset script exit with code 2?▼

Exit code 2 signals a path-safety violation, meaning reset.mjs detected paths containing .. or absolute paths outside the project root. The correct response is to report the error and stop, never retry with modified paths.

Can I skip the dry-run step for a quick reset?▼

No. The dry-run plan is mandatory before every execution with no fast path, and confirmation requires the literal word yes. Ambiguous replies like ok or sure are treated as cancellation.