---
name: status
description: Show the doc-hygiene lifecycle state for the current project — last check/clean/reminded timestamps and whether a report exists. Read-only, no model, no scan. Invoked by `/os-doc-hygiene:status`.
---

# Status Skill

Read-only. No model, no scan, no mutation. Reads the three lifecycle
timestamps plus report presence via `state_store.py` and reports them.

`state_store.py` is a module (no CLI), so call it via `python3 -c`:

```bash
python3 -c '
import sys, os
sys.path.insert(0, os.environ["CLAUDE_PLUGIN_ROOT"] + "/scripts")
from state_store import StateStore, resolve_project_root
from pathlib import Path
s = StateStore(resolve_project_root(Path(os.getcwd())))
def fmt(dt): return dt.isoformat() if dt else "never"
print("last_check:    " + fmt(s.get_last_check()))
print("last_clean:    " + fmt(s.get_last_clean()))
print("last_reminded: " + fmt(s.get_last_reminded()))
print("report:        " + ("present" if s.read_report() else "none"))
'
```

Present the output as a short human summary, for example:

```
doc-hygiene status for: <project-root>

  last check     2026-06-20T14:03:11+00:00
  last clean     never
  last reminded  2026-06-24T09:00:00+00:00
  report         present  (run /os-doc-hygiene:check to refresh)
```

Do not classify or distill anything — this is a timestamp read only.