# Necromancy

> Recover a Claude Code session that died before a CHECKPOINT was written

- **Type:** Skill
- **Install:** `agentstack add skill-dtiger1889-ops-claude-harness-toolbox-necromancy`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [dtiger1889-ops](https://agentstack.voostack.com/s/dtiger1889-ops)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [dtiger1889-ops](https://github.com/dtiger1889-ops)
- **Source:** https://github.com/dtiger1889-ops/claude-harness-toolbox/tree/main/skills/necromancy

## Install

```sh
agentstack add skill-dtiger1889-ops-claude-harness-toolbox-necromancy
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

Recover state from a dead session's on-disk transcript. The script does the heavy
lifting deterministically; you NEVER Read raw session JSONL into context (files run
to multiple MB -- the digest exists precisely to avoid that).

Script: `~/.claude/skills/necromancy/necromancy.ps1` (run via the PowerShell tool;
Windows-first, like the rest of this toolbox's scripts).

1. LIST. Run with the project folder the user means (default: the folder they're
   asking about, usually cwd):
   `& "$env:USERPROFILE\.claude\skills\necromancy\necromancy.ps1" -Project `
   Output: newest-first sessions with title, first ask, size, and checkpoint state
   ("NO CHECKPOINT WRITE" or "N assistant msgs after last write").

2. PICK the dead session. The newest file is almost always the CURRENT live session
   -- skip it. A dead candidate is: NO CHECKPOINT WRITE, or many assistant messages
   after the last checkpoint write, matching the timeframe/topic the user describes.
   If ambiguous, show them the list lines and ask which one.

3. DIGEST. `... necromancy.ps1 -Project  -Session `
   Sections: FIRST ASK, USER MESSAGES (their decisions -- the gold), FINAL ASSISTANT
   STATE, FILES WRITTEN/READ, COMMANDS, GIT/COMMITS, VERSIONS, TESTS, ERRORS.

4. SYNTHESIZE a resume summary FROM THE DIGEST ONLY: what was asked, what got
   decided, what was completed vs in flight when it died, and the literal next
   action. Verify claims about file state against the ACTUAL files (a dead session's
   last words may describe work it never flushed) before asserting anything as done.

5. OFFER TO PERSIST. If the project has a CHECKPOINT.md that predates the dead
   session, the natural close is updating it (the /checkpoint skill) so the
   recovered state has a durable home. Do it when the user confirms resuming.

Gotchas:
- Slug mapping is `[^A-Za-z0-9] -> '-'` on the project path; the script falls back
  case-insensitively (Windows store dirs vary in case; same inode either way).
- Digest caps per category (precision over recall). If a needed detail is missing,
  re-run digest, then at worst grep the single session file for a specific string
  (`grep -o` a narrow pattern) -- still never full-Read it.
- Anchor extraction is regex-only and can misfire; treat ERRORS/COMMITS lines as
  leads, not verified facts.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [dtiger1889-ops](https://github.com/dtiger1889-ops)
- **Source:** [dtiger1889-ops/claude-harness-toolbox](https://github.com/dtiger1889-ops/claude-harness-toolbox)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-dtiger1889-ops-claude-harness-toolbox-necromancy
- Seller: https://agentstack.voostack.com/s/dtiger1889-ops
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.