Inner Life Reflect

Your agent repeats the same patterns without learning. inner-life-reflect adds self-reflection with trigger detection and quality gates — your agent observes...

Security Scan

The skill's declared purpose (self-reflection), the files it reads/writes, and the minimal runtime requirements (jq plus memory files) are consistent and proportionate to its stated behavior.

Purpose & Capability

Name/description (self-reflection) match what the skill reads/writes (memory/inner-state.json, habits.json, drive.json, diary) and what it produces (memory/SELF.md). The explicit dependency on inner-life-core and the required jq binary are reasonable for parsing JSON memory files.

Instruction Scope

SKILL.md gives concrete trigger rules, quality gates, and file paths to read/write; it does not instruct reading unrelated system files or external endpoints. It leaves scheduling/implementation details to the agent (micro/meso/macro cadence), which is expected for an instruction-only skill but means actual behavior depends on the agent implementation.

Install Mechanism

No install spec and no code files — lowest risk. The only runtime requirement is jq, which is declared; nothing is downloaded or executed from external URLs.

Credentials

No environment variables, credentials, or config paths requested beyond reading/writing the declared memory files. The declared reads/writes align with the skill's purpose.

Persistence & Privilege

always:false (default) and no system-wide config changes are requested. The skill writes only its own memory files (SELF.md and habits.json) and explicitly forbids auto-editing SOUL.md; this persistence is proportional to its function.

Assessment

This skill appears internally consistent, but review the following before installing: 1) inner-life-core must be initialized (memory/inner-state.json and memory/habits.json); follow the provided init instructions if not. 2) The skill will read and write files under memory/ (SELF.md and habits.json); ensure those files live in a location you trust and that storing behavioral observations there is acceptable. 3) It relies on the agent to implement periodic checks and quality gates — if you do not want autonomous writes, restrict the agent's ability to invoke skills or review SELF.md entries after creation. 4) Ensure jq is available in the runtime environment. If you need stronger guarantees about when/where entries are written, consider inspecting or sandboxing the agent implementation that executes these instructions.

Self-reflection that actually works. No forced journaling, no filler.

Requires: inner-life-core

Prerequisites Check

Before using this skill, verify that inner-life-core has been initialized:

1. Check that memory/inner-state.json exists
2. Check that memory/habits.json exists

If either is missing, tell the user: "inner-life-core is not initialized. Install it with clawhub install inner-life-core and run bash skills/inner-life-core/scripts/init.sh." Do not proceed without these files.

What This Solves

Without reflection, agents accumulate experience but never learn from it. They make the same mistakes, miss the same patterns, and their personality stays frozen.

inner-life-reflect adds a trigger-based reflection system with quality gates. Your agent writes to SELF.md only when something meaningful happens — not on a schedule, not as routine filler.

Core Principle

• SOUL.md = who you are (foundation, change only with user approval)
• SELF.md = who you're becoming (living observations)
• Schedule the check, not the content — checks can be periodic; entries must be genuine

Triggers

Hard Triggers (write now)

Create/update SELF.md entry when:

• You were corrected on reasoning style or behavior pattern
• You noticed a repeated bias or avoidance pattern (>=2 times)
• You made a decision that clearly reflects preference or aversion
• You caught a blind spot that changed your behavior

Soft Triggers (consider writing)

• Subtle tendency shift detected
• New tone pattern in interactions
• Mild preference signal from user

If only soft triggers exist and quality is low: skip entry, update state only.

Quality Gate

Before writing to SELF.md, pass ALL 4 checks:

1. Specificity — concrete behavior, not generic statement
2. Evidence — based on recent sessions, not vibes
3. Novelty — not a duplicate of last 3 entries
4. Usefulness — could influence future behavior

If any check fails: no SELF entry, just state update.

SELF.md Format

Short dated entries organized by section:

## Tendencies
- [2026-03-01] I default to verbose explanations when a short answer would suffice

## Preferences
- [2026-03-01] I prefer structured approaches over exploratory ones

## Blind Spots
- [2026-02-28] I underestimate how long file operations take

## Evolution
- [2026-03-01] Shifted from always asking permission to acting within trust bounds

Review Cadence

Micro check (every 3 hours)

Scan for hard/soft triggers. Does NOT auto-write — only decides if reflection is due.

Meso review (weekly)

• Read last 7 daily logs + SELF.md
• Detect recurring shifts
• Update sections only if real change occurred

Macro review (monthly)

• Write 3-5 sentence evolution narrative
• Compare against previous month
• Falsifiability check: if entries are stale/generic for a month, adjust trigger thresholds

State Integration

Reads: inner-state.json, habits.json, drive.json, diary (latest)

Writes: SELF.md, habits.json (when patterns crystallize into habits)

During weekly review:

• Read habits.json → patterns with strength >= 3 are tendencies
• Read drive.json → seeking active > 2 weeks are interests
• Read diary for the week → sustained observations become entries

Boundaries

• SELF.md is autonomous observation space
• SOUL.md is never auto-modified
• If SELF suggests SOUL changes: propose to user, do not auto-edit

When Should You Install This?

Install this skill if:

• Your agent keeps making the same mistakes
• You want your agent to develop a personality over time
• Your agent's self-model is stale or nonexistent
• You want quality-gated reflection, not forced journaling

Part of the openclaw-inner-life bundle. Requires: inner-life-core