reflector

Log outcomes and refine PRINCIPLES.md through daily and weekly review prompts.

4|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/KhyKd/reflector --skill reflector-khykd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reflector
Source: https://github.com/KhyKd/reflector/tree/main
Command: npx skills add https://github.com/KhyKd/reflector --skill reflector-khykd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Structured self-improvement for AI agents is hampered by failure to learn from experience; Reflector provides a structured feedback loop to translate interactions into improved decision-making through outcome logging, daily reviews, and weekly principle refinement.

Core Features & Use Cases

  • Outcome tracking: logging results from daily reviews and tasks
  • Daily reviews: classify signals and identify patterns
  • Weekly principle refinement: assess and update PRINCIPLES.md with evidence
  • Memory and history: provides memory/reflector/outcomes.jsonl and memory/reflector/principles-history.jsonl
  • Cron scheduling: prompts to automate reviews

Quick Start

Run the initialization script from your workspace root to create PRINCIPLES.md, memory storage, and the daily/weekly review prompts.

Frequently Asked Questions about reflector

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

FAQPage Schema
How do I make AI agents learn from past interactions and outcomes?

To make AI agents learn from past interactions, you implement a structured reflection loop that logs outcomes, identifies patterns during daily reviews, and refines decision-making principles weekly. This translates task history into measurable behavioral improvements.

How do I automate daily reviews for AI agent memory and outcome tracking?

You automate daily reviews by using cron-based scheduling prompts to classify signals and identify patterns from logged tasks. This automated outcome tracking feeds agent memory to evolve future decision-making.

What is the best way to refine AI agent principles from daily task history?

The best way to refine AI agent principles is through a weekly refinement process that assesses logged outcomes and updates a PRINCIPLES.md file with evidence. This ensures decision-making evolves based on historical performance.

Do I need Node.js 18+ to run automated agent reflection loops?

Yes, you need Node.js 18+ to run the automated reflection loops. The environment requires this version to execute initialization scripts that create memory storage and cron-based review prompts.

How does structured outcome logging work for AI agent memory?

Structured outcome logging works by storing task results and historical patterns in JSONL files within a memory directory. This history tracks agent decisions and outcomes to provide evidence for weekly principle refinement.

When should I not use a structured reflection loop for agent self-improvement?

You should avoid a structured reflection loop if your agent tasks are strictly stateless or lack measurable outcomes. Without task history to log and analyze, the daily reviews and weekly principle refinement cannot identify meaningful patterns.