reflect

Extracts confidence-ranked learnings from conversations and persists them to agent history and decision files.

2|Updated Jul 24, 2026
One-click install
npx skills add https://github.com/elbruno/ElBruno.MagenticUI --skill reflect-elbruno
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reflect
Source: https://github.com/elbruno/ElBruno.MagenticUI/tree/main/.squad/templates/skills/reflect
Command: npx skills add https://github.com/elbruno/ElBruno.MagenticUI --skill reflect-elbruno

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams repeatedly make the same mistakes because corrections and successful patterns from conversations are never captured. This Skill analyzes conversations for learning signals and proposes structured updates to squad knowledge files so insights survive across sessions. ## Core Features & Use Cases - Confidence-Ranked Signal Detection: Classifies learnings as HIGH (user corrections), MEDIUM (praise, edge cases), or LOW (accumulated preferences) with explicit thresholds for when to propose changes. - Targeted Knowledge Routing: Routes learnings to the right destination: agent-specific history.md files, team-wide decisions inbox, or skill improvement recommendations. - Approval-Gated Persistence: Always shows proposed changes in a structured summary and waits for user approval before writing to any file. - Use Case: After a user says "No, use the code search tools first, grep is too slow", the Skill captures a HIGH-confidence constraint and appends it to the agent's history.md so the mistake is never repeated. ## Quick Start Ask the assistant to reflect on this session and capture any learnings from corrections or feedback into the squad knowledge files.

Frequently Asked Questions about reflect

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

FAQPage Schema
How do I capture learnings from AI agent conversations?

Invoke the reflect Skill after user corrections, praise, or discovered edge cases. It scans the conversation for learning signals, classifies them by confidence level, and proposes structured updates to agent history or team decision files.

What triggers the reflect learning capture process?

HIGH priority triggers include explicit corrections like "no" or "wrong". MEDIUM triggers include praise like "perfect" and discovered edge cases. LOW triggers are repeated usage patterns reviewed at session end.

Where does reflect store captured learnings?

Agent-specific learnings append to .squad/agents/{agent}/history.md under a Learnings section. Team-wide patterns go to .squad/decisions/inbox/ as proposal files that a lead agent reviews before merging into decisions.md.

Does reflect modify files without user approval?

No. The Skill always displays proposed changes in a structured summary with source quotes and target files, then waits for explicit approval (Y/n/edit) before persisting anything to disk.

When should I not use conversation reflection?

Skip reflection for simple one-off questions with no reusable pattern, exploratory discussions without concrete decisions, or learnings already recorded in history.md or decisions.md to avoid duplicate entries.