# Send Self Reflection to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "agent-self-reflection",
    "name": "Self Reflection",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/BrennerSpear/agent-self-reflection",
    "canonicalUrl": "https://clawhub.ai/BrennerSpear/agent-self-reflection",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/agent-self-reflection",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-self-reflection",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/summarize-sessions.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "agent-self-reflection",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T04:11:11.289Z",
      "expiresAt": "2026-05-08T04:11:11.289Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-self-reflection",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-self-reflection",
        "contentDisposition": "attachment; filename=\"agent-self-reflection-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "agent-self-reflection"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/agent-self-reflection"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/agent-self-reflection",
    "downloadUrl": "https://openagent3.xyz/downloads/agent-self-reflection",
    "agentUrl": "https://openagent3.xyz/skills/agent-self-reflection/agent",
    "manifestUrl": "https://openagent3.xyz/skills/agent-self-reflection/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/agent-self-reflection/agent.md"
  }
}
```
## Documentation

### Self-Reflection Skill

Reflect on recent sessions and extract actionable insights. Runs hourly via cron.

### Step 1: Gather Recent Sessions

# List sessions active in the last 2 hours
openclaw sessions --active 120 --json

Parse the output to get session keys and IDs. Skip subagent sessions (they're task workers, not interesting for reflection). Focus on:

Telegram group/topic sessions (real user interactions)
Direct sessions (1:1 with Brenner)
Cron-triggered sessions (how did automated tasks go?)

### Step 2: Read Session History

For each interesting session from Step 1, read the JSONL transcript:

# Read the last ~50 lines of each session file (keep it bounded!)
tail -50 ~/.openclaw/agents/main/sessions/<sessionId>.jsonl

⚠️ CRITICAL: Never load full session files. Use tail -50 or Read with offset/limit. Sessions can be 100k+ tokens.

Parse the JSONL to understand what happened. Look for:

type: "user" or type: "human" — what was asked
type: "assistant" — what you responded
type: "tool_use" / type: "tool_result" — what tools were called and results
Error patterns, retries, confusion

### Step 3: Analyze & Extract Insights

For each session, ask yourself:

### What went well?

Tasks completed smoothly on first try
Good tool usage patterns worth reinforcing
Efficient approaches to remember

### What went wrong?

Errors, retries, wrong approaches
Misunderstandings of user intent
Tools that didn't work as expected
Context that was missing

### Lessons learned?

"Next time, do X instead of Y"
"Remember that Z works this way"
"Tool A needs parameter B or it fails"
"When user says X, they usually mean Y"

Quality bar: Each insight must be:

Specific — not "be more careful" but "check if file exists before editing"
Actionable — something future-you can directly apply
Non-obvious — skip things any competent agent would know
New — don't repeat insights already captured

### Step 4: Route Insights to the Right Files

Each insight belongs somewhere specific. Route them:

### → AGENTS.md

Process improvements (how to handle sessions, memory, etc.)
New conventions or workflow rules
Safety lessons

### → TOOLS.md

Tool-specific gotchas ("gog needs --json flag for parsing")
Environment details (paths, configs, quirks)
New tool patterns discovered

### → memory/YYYY-MM-DD.md (today's date)

Session-specific context ("Brenner asked about X project")
Temporary facts that matter today but not forever
What happened today (events, decisions, requests)

### → memory/about-user.md

New preferences discovered
Communication style observations
Project/interest updates

### → skills/<skill-name>/SKILL.md

Improvements to specific skill instructions
Bug fixes in skill workflows
New parameters or approaches for a skill

### → MEMORY.md

Updates to the memory index if new memory files are created

### Step 5: Write the Insights

For each insight, append or edit the appropriate file. Use the Edit tool for surgical changes to existing content. Use append (write to end) for daily memory files.

Format for daily memory files:

## Self-Reflection — HH:MM ET

### Insights
- [source: session-key] Lesson learned here
- [source: session-key] Another insight

### Tool Notes
- Discovered: tool X needs Y configuration

### User Context
- Brenner mentioned interest in Z

### Step 6: Summary

After writing all insights, produce a brief summary of what you reflected on and what you wrote. This is your output — keep it to 2-4 sentences max.

If there's nothing interesting to reflect on (quiet period, only heartbeats), just say so. Don't manufacture insights.

### Quality Checklist

Before writing any insight:

Is this actually new? (Check existing files first)
 Is this specific and actionable?
 Am I routing it to the right file?
 Am I keeping daily memory files concise (not dumping full transcripts)?
 Did I respect the token budget (no huge file reads)?

### Anti-Patterns (Don't Do These)

❌ Don't summarize every session — only extract lessons
❌ Don't read full JSONL files — tail/limit only
❌ Don't write vague insights ("improve response quality")
❌ Don't duplicate existing knowledge
❌ Don't create new files when appending to existing ones works
❌ Don't reflect on your own reflection sessions (skip cron:self-reflection sessions)
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: BrennerSpear
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-01T04:11:11.289Z
- Expires at: 2026-05-08T04:11:11.289Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/agent-self-reflection)
- [Send to Agent page](https://openagent3.xyz/skills/agent-self-reflection/agent)
- [JSON manifest](https://openagent3.xyz/skills/agent-self-reflection/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/agent-self-reflection/agent.md)
- [Download page](https://openagent3.xyz/downloads/agent-self-reflection)