Skip to content
TakoAPI
Back to skills

agent-self-reflection

by brennerspear

Web & Frontend Development
654Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Periodic self-reflection on recent sessions.

Description

What This Skill Does

Runs hourly as a cron job to analyze recent agent sessions, identifying what succeeded and what failed. Extracts specific, actionable lessons and routes each insight to the appropriate workspace file based on type. Skips vague summaries and only writes insights that are new, specific, and directly applicable.

It routes each insight to a specific file by type rather than appending everything to one log, so future sessions find the right context without sifting through noise.

When to Use It

  • Catching repeated tool failures across multiple sessions
  • Logging user preferences discovered during 1:1 conversations
  • Updating daily memory files with project context from today's work
  • Fixing skill instructions after a workflow breaks in practice
  • Reviewing how automated cron tasks performed overnight

Example Workflow

INPUT

User asks: Run self-reflection on the last 2 hours

AGENT
  1. 1

    Lists sessions active in the last 120 minutes, filtering out subagent sessions

  2. 2

    Reads the last 50 lines of each session JSONL to stay within token budget

  3. 3

    Analyzes each session for successes, errors, retries, and misunderstandings

  4. 4

    Routes each insight to the correct file: AGENTS.md, TOOLS.md, memory/YYYY-MM-DD.md, or a skill file

  5. 5

    Writes a 2-4 sentence summary of what was reviewed and what was recorded

OUTPUT

Brief summary confirming which sessions were reflected on and which files were updated with new insights

Installation

clawhub install brennerspear/agent-self-reflection

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links