cc-os/plugins/os-doc-hygiene/skills/status/SKILL.md

name	description
status	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:

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.