shalintripathi/organic-os / plugin/skills/hoo-reflector
hoo-reflector
VerifiedUse to distill lessons from recent signals and outcomes - "run the reflector", weekly routine step 4, or "what did we learn". Proposes skillbook deltas; the curator merge is gated.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.4 KB |
SKILL.md
View on GitHub---
name: hoo-reflector
description: Use to distill lessons from recent signals and outcomes - "run the reflector", weekly routine step 4, or "what did we learn". Proposes skillbook deltas; the curator merge is gated.
---
# Reflector (weekly) - propose deltas, never write directly
1. Read: all signals/ since the last reflection, outcomes/ records, current
skillbook.md, the last reflections/ file.
2. Propose deltas, each referencing an entry ID or NEW:
- NEW lesson (with evidence tag + source: which signal/outcome proves it)
- `S-nnn helpful+1` / `harmful+1` (an outcome confirmed/contradicted it)
- `S-nnn deprecate` (contradicted repeatedly - cite the evidence)
- `S-nnn edit: <new text>` (sharpen wording; meaning preserved)
NEVER propose a full rewrite. NEVER propose deleting lines.
3. Write reflections/YYYY-Www.md listing every delta + evidence.
4. Stale review: list the entries whose last-confirmed date has aged past
their evidence tier's threshold.
`PYTHONPATH="$CLAUDE_PLUGIN_ROOT/lib" python3 -c "..."` snippet calling
`core.contracts.skillbook_stale(<brain>)`, which returns
`{id, evidence, last_confirmed, days_stale, threshold, text}` per entry,
most stale first. Thresholds by tier: anecdotal 90 days, moderate 180,
strong 365 (canonical in `core.contracts.STALE_DEFAULTS`; a site can
override any tier with `skillbook: {stale_days: {...}}` in
site-profile.yaml). Deprecated entries never appear here.
Present each one for re-validation next to the evidence from this
week's signals and outcomes that would confirm or contradict it:
- Re-confirmed (the lesson still holds): propose it as a delta applied
through `skillbook_update(root, "S-nnn")`, which stamps
last-confirmed to today. That refresh is the point of the review.
- Cannot be re-confirmed: PROPOSE deprecation as a delta, citing what
is missing. The reflector NEVER auto-deprecates and never writes the
book on its own - a stale entry is a question for a human, not a
verdict, exactly like every other delta in step 2.
An entry nobody can speak to this week is left as it is and listed
again next week. Age is a prompt to re-check, never a reason to delete.
5. Curator merge: if the profile marks curator as gated (default), present the
deltas for approval (in-session or channel); on approval apply each via
`skillbook_append` / `skillbook_update` calls - one call per delta.
6. Commit "reflection: YYYY-Www" if git.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |