self-reflection

Log mistakes and lessons learned via heartbeat-triggered reflections.

6|1|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/Ven0m0/claude-config --skill self-reflection-ven0m0
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: self-reflection
Source: https://github.com/Ven0m0/claude-config/tree/main/claude/skills/self-reflection
Command: npx skills add https://github.com/Ven0m0/claude-config --skill self-reflection-ven0m0

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, date, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the issue of AI agents repeating mistakes by creating a structured feedback loop for continuous self-improvement and building institutional memory.

Core Features & Use Cases

  • Automated Reflection Triggers: Integrates with heartbeats to prompt regular self-assessment.
  • Mistake Logging: Allows agents to log specific errors, lessons learned, and corrective actions.
  • Memory Persistence: Stores lessons in a human-readable format for future reference and analysis.
  • Use Case: An AI agent repeatedly makes a similar coding error. This skill ensures the agent reflects on the mistake, logs the lesson, and avoids repeating it in future tasks.

Quick Start

Run the self-reflection check command to see if a reflection is needed.

Frequently Asked Questions about self-reflection

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I stop my AI agent from repeating the same coding mistakes?▼

AI self-improvement works by creating a structured feedback loop that tracks mistakes and logs lessons learned. It facilitates institutional memory through regular, heartbeat-triggered reflections and stores insights in a persistent, human-readable format for future reference.

How do I set up automated self-reflection triggers for an AI agent?▼

Automated self-reflection triggers integrate with heartbeats to prompt regular self-assessment. This allows agents to automatically log specific errors, record lessons learned, and execute corrective actions, building persistent memory for future tasks.

Do I need bash, jq, and date to run AI self-improvement scripts?▼

Yes, bash, jq, and date are required dependencies for execution and state management. These tools enable the agent to process reflection logs, parse JSON state, manage timestamps, and store insights in a human-readable format.

What is the best way to build institutional memory for an AI agent?▼

The best way to build institutional memory is by implementing persistent storage of lessons learned. This Skill logs mistakes and corrective actions in a human-readable format, allowing the agent to reference past insights and avoid repeating errors.

How does an AI agent store lessons learned from debugging errors?▼

An AI agent stores lessons learned through memory persistence. The agent logs specific errors, lessons, and corrective actions, saving them in a human-readable format for future reference and analysis during subsequent debugging tasks.

Can I review past AI reflections and logged mistakes in a human-readable format?▼

Yes, you can review past AI reflections because memory persistence stores lessons in a human-readable format. This allows developers to easily reference and analyze logged mistakes, lessons learned, and corrective actions for future improvement.