po4yka/rust-skills / skills/rust-panic-safety
rust-panic-safety
VerifiedUse when guarding an extern "C", extern "system", or JNI entry point with catch_unwind, choosing panic = "unwind" or "abort", installing a panic hook, disposing of a panic payload, fixing an UnwindSafe bound with AssertUnwindSafe, or triaging an abort such as "panic in a function that cannot unwind". Also use when a panic can escape a foreign callback, spawned task, thread, or Drop, or when replacing unwrap or expect on an FFI-reachable path. Owns the panic policy at a C ABI boundary.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 11.5 KB |
| references/boundary-patterns.md | markdown | 16.4 KB |
| references/drop-guard.md | markdown | 2.0 KB |
| references/jni-boundary.md | markdown | 8.4 KB |
| references/panic-hook.md | markdown | 3.4 KB |
| references/panic-strategy.md | markdown | 2.2 KB |
| references/unwind-state.md | markdown | 2.3 KB |
| references/unwrap-audit.md | markdown | 10.0 KB |
references/unwind-state.md
View on GitHub# Keep data valid when a panic passes through
Read this file when code inside a `catch_unwind` guard mutates shared state, holds a lock, or
runs a section that must not half-complete. `catch_unwind` returns control, so whatever the
closure touched is still alive. Panic safety of data is a separate problem from panic safety of
the boundary.
- **Lock poisoning.** `std::sync::Mutex` marks itself poisoned when a holder panics. State the
policy at each lock (the `rust-discipline` skill owns it). `parking_lot` locks do not poison:
you get no warning, so state the invariant in the type.
- **Restore the invariant with a guard.** Move the "put it back" step into a `Drop`
implementation so unwinding runs it. Set the flag, create the guard, do the work.
- **Never panic in `Drop`.** A panic inside a `Drop` that runs during unwinding aborts with
`panic in a destructor during cleanup`. A `Drop` implementation must be infallible: log the
failure and continue.
- **Do not leave a `&mut` in a torn state.** If you split a value into parts and panic in the
middle, the caller observes the parts. Build the new value first, then commit with a single
assignment.
- **Force an abort where an unwind is unacceptable.** In a critical section that must not
half-complete, arm a bomb and disarm it on success:
```rust
struct AbortOnUnwind {
armed: bool,
}
impl Drop for AbortOnUnwind {
fn drop(&mut self) {
if self.armed {
std::process::abort();
}
}
}
let mut bomb = AbortOnUnwind { armed: true };
// ... section that must complete or kill the process ...
bomb.armed = false;
```
## `UnwindSafe` and `AssertUnwindSafe`
`catch_unwind` requires the closure to be `UnwindSafe`. The bound is a warning, not a proof:
it marks values that a panic could leave in a broken but observable state. `&mut T` and
interior-mutable types are not `UnwindSafe`.
```rust
use std::panic::{catch_unwind, AssertUnwindSafe};
// The compiler cannot prove `state` is consistent after a panic. You must.
let result = catch_unwind(AssertUnwindSafe(|| run(&mut state)));
```
When you write `AssertUnwindSafe`, add a comment that names the invariant you checked, in the
same style as a `SAFETY` comment. If you cannot name one, restore the invariant instead: drop
the object, rebuild it, or mark it poisoned so later calls fail fast.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |