self-reflect

Generate structured reflection documents with YAML frontmatter after stakeholder corrections.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/Busboom-Foo/meetupfu --skill self-reflect-busboom-foo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: self-reflect
Source: https://github.com/Busboom-Foo/meetupfu/tree/main/.claude/skills/self-reflect
Command: npx skills add https://github.com/Busboom-Foo/meetupfu --skill self-reflect-busboom-foo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps agents convert stakeholder corrections into a formal, auditable reflection document that captures what happened and guides future improvements.

Core Features & Use Cases

  • Capture stakeholder feedback and the triggering event.
  • Analyze root causes such as missing instructions, ambiguous prompts, or ignored steps, and propose concrete fixes.
  • Output a reflection document at docs/clasi/reflections/ containing sections What Happened, What Should Have Happened, Root Cause, and Proposed Fix, with an optional TODO.

Quick Start

Trigger a guided reflection automatically after a stakeholder correction by producing a structured document that records events, causes, and proposed improvements.

Frequently Asked Questions about self-reflect

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

FAQPage Schema
How do I generate a structured reflection document after a stakeholder correction?

To generate a structured reflection document after a stakeholder correction, trigger a guided reflection that captures what happened, what should have happened, the root cause, and proposed fixes. The output is saved as a file under docs/clasi/reflections.

What is the best way to perform root cause analysis on missed instructions in AI agent workflows?

Root cause analysis on missed instructions in AI agent workflows is performed by analyzing the triggering event and stakeholder feedback to identify why steps were ignored or prompts were ambiguous. This analysis populates the Root Cause section of the reflection document.

How do I capture stakeholder feedback for process improvement in AI ops?

Capture stakeholder feedback for process improvement in AI ops by logging the correction event and proposed fixes into an auditable reflection document. This document includes YAML frontmatter with a name and description, followed by structured improvement sections.

Does the reflection document format support adding TODOs for post-review improvements?

Yes, the reflection document format supports an optional TODO section for post-review improvements. This section is appended after the required What Happened, What Should Have Happened, Root Cause, and Proposed Fix sections to track future actions.

Can I use this approach for post-review improvements across different task scenarios?

Yes, you can use this reflection approach for post-review improvements across typical task scenarios such as missed instructions, ambiguity, or ignored steps. It applies broadly to AI agent workflows involving error corrections to guide future behavior.