self-reflect

Capture stakeholder corrections and write a structured reflection document.

1|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/busboom-software-studio/design-trainer --skill self-reflect-busboom-software-studio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: self-reflect
Source: https://github.com/busboom-software-studio/design-trainer/tree/main/.claude/skills/self-reflect
Command: npx skills add https://github.com/busboom-software-studio/design-trainer --skill self-reflect-busboom-software-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the creation of a structured reflection document after a stakeholder correction, ensuring learning is codified and future work is guided by clear insights.

Core Features & Use Cases

  • Capture error details: Record what action or decision point failed and cite the relevant step.
  • Analyze root cause: Classify the gap as missing, ambiguous, ignored, or emergent, to guide fixes.
  • Propose and record fixes: Recommend concrete changes and optionally generate a TODO for implementation.
  • Write reflection output: Create docs/clasi/reflections/YYYY-MM-DD-slug.md with metadata and a structured narrative.
  • Use cases: For post-correction reviews in AI-agent workflows and software development retrospectives.

Quick Start

Trigger the self-reflect process immediately after stakeholder corrections to generate the reflection document.

Frequently Asked Questions about self-reflect

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

FAQPage Schema
How do I document root causes after a stakeholder correction in a post-mortem?

To document root causes after a stakeholder correction, capture the error details and classify the gap as missing, ambiguous, ignored, or emergent. This structured reflection process records what happened and outlines concrete corrective actions.

How do I automate reflection documentation for software development retrospectives?

Automate reflection documentation by triggering the process immediately after feedback cycles. It automatically writes a structured narrative file with metadata to docs/clasi/reflections/YYYY-MM-DD-slug.md, ensuring learning is codified for future work.

What is the best way to turn process improvement feedback into a structured reflection?

The best way to turn process improvement feedback into a structured reflection is to record the failed decision point, analyze the root cause classification, and propose concrete fixes. Optionally, generate a TODO file to track the implementation of these corrective actions.

Can I generate a TODO file automatically when documenting post-correction reviews?

Yes, you can automatically generate a TODO file during post-correction reviews. After recording the error details and analyzing the root cause, the process optionally creates a TODO to ensure the proposed corrective actions are implemented.

When should I use structured reflection in AI-agent workflows?

Use structured reflection in AI-agent workflows immediately after a stakeholder correction or during feedback cycles. It captures what action failed, identifies the root cause, and writes a reflection document to guide future process improvements.