self-reflection

Capture friction reflections into daily markdown files under agent/shared/reflections.

2|1|Updated Apr 10, 2023
One-click install
npx skills add https://github.com/popoffvg/dotfiles --skill self-reflection-popoffvg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: self-reflection
Source: https://github.com/popoffvg/dotfiles/tree/main/skills/self-reflection
Command: npx skills add https://github.com/popoffvg/dotfiles --skill self-reflection-popoffvg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Capture short, actionable reflections when instructions, workflows, or tools cause friction. Use to improve future agent runs.

Core Features & Use Cases

  • Structured reflection storage: Each day writes to a dedicated file under agent/shared/reflections/YYYY-MM-DD.md.
  • Actionable insights: Emphasize root cause and concrete improvements to avoid repeating issues.
  • Rotation and retention: Old reflections are pruned after ten days automatically on startup to keep storage lean.

Quick Start

Append a concise reflection to agent/shared/reflections/YYYY-MM-DD.md for today's date.

Frequently Asked Questions about self-reflection

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

FAQPage Schema
How do I capture actionable reflections when workflows cause friction?

To capture actionable reflections when workflows cause friction, append a concise entry to a daily markdown file. This stores insights structured around what happened, the root cause, and what would help to improve future agent runs.

What is the best way to log agent session learning for future runs?

Logging agent session learning is best done by writing structured daily markdown files. This approach captures root causes and concrete improvements, ensuring consistent learning across sessions to enhance efficiency and outcomes over time.

How does automated reflection file retention work for daily markdown logs?

Automated reflection file retention works by pruning older daily markdown logs beyond ten days on startup. This mechanism keeps storage lean while preserving recent workflow friction entries for ongoing agent improvement.

What structured template should I use for self-reflection entries?

A structured self-reflection template should include what happened, the root cause, and what would help. This format enforces actionable insights to avoid repeating workflow issues and improves future agent performance.

Where are daily workflow reflection entries stored?

Daily workflow reflection entries are stored in dedicated markdown files under the agent/shared/reflections directory. Each file is named with the date in YYYY-MM-DD format to organize session learning chronologically.

Do I need external dependencies to start logging workflow reflections?

No external dependencies are needed to start logging workflow reflections. The system operates independently by writing structured insights to local markdown files, requiring no additional components or setup.