observe

name	observe
description	Record falsifiable predictions, score outcomes, inspect calibration and a compact scorecard, or audit/delete Recursive Observe's private local evidence. Use when a user asks to track whether an agent task succeeds, measure confidence, review prediction accuracy, or manage Observe data without changing the current repository.

Observe

Use the bundled deterministic CLI. Do not emulate its ledger with prose or create project files. Resolve scripts/observe.py relative to this SKILL.md; never run an untrusted project-local file with the same name.

Record and score

Before uncertain, meaningful work, record one falsifiable expected result:

python3 <skill-dir>/scripts/observe.py predict \
  --task "harden the parser" \
  --expect "the malformed fixture is rejected and the full suite stays green" \
  --confidence 0.75

After observable evidence exists, score the printed identifier. Never infer success from intent or score an unfinished task.

python3 <skill-dir>/scripts/observe.py outcome PREDICTION_ID \
  --result hit --notes "fixture and suite passed"

Keep task, expect, and notes short. Do not include prompts, source contents, secrets, credentials, or personal data. The runtime applies defense-in-depth redaction before writes.

Review evidence

Use stats for calibration buckets or scorecard for the compact proof surface. Add --json when another tool needs structured output.

python3 <skill-dir>/scripts/observe.py stats
python3 <skill-dir>/scripts/observe.py scorecard --json

Protect privacy

Observe stores sanitized evidence below ~/.recursive-harness/observe, never the working repository. The runtime intentionally accepts no state-path argument or environment override. Read the privacy contract when the user asks what is stored, where it lives, how long it remains, or how uninstall affects it.

Audit aggregate metadata without printing prediction text:

python3 <skill-dir>/scripts/observe.py privacy audit --json

Delete all Observe records only on an explicit user request. Preview first; purge remains a dry run until --apply is present.

python3 <skill-dir>/scripts/observe.py privacy purge
python3 <skill-dir>/scripts/observe.py privacy purge --apply

Installing or invoking this skill must not edit AGENTS.md, CLAUDE.md, .claude/, .codex/, hooks, workflows, or any other file in the active repository.