reflection

Analyze task status and root causes to distill actionable principles.

1|1|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/csuzngjh/principles --skill reflection-csuzngjh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reflection
Source: https://github.com/csuzngjh/principles/tree/main/claude/skills/reflection
Command: npx skills add https://github.com/csuzngjh/principles --skill reflection-csuzngjh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses task stagnation and user frustration by performing a deep metacognitive reflection to identify root causes and distill lessons into actionable principles.

Core Features & Use Cases

  • Status Assessment: Analyzes current progress against initial goals and resource consumption.
  • Pain Point Identification: Detects issues like task stalls, repeated errors, user dissatisfaction, or architectural decay.
  • Root Cause Analysis: Dives deep into the 'why' behind detected pain points.
  • Evolutionary Logging: Records lessons learned and refines principles to prevent future mistakes.
  • Recovery Planning: Outlines a clear path forward after reflection, ensuring context is preserved.
  • Use Case: When an AI agent has been stuck on a coding problem for several hours, this Skill can be invoked to analyze why, log the failure, and suggest a new approach or principle to avoid similar issues in the future.

Quick Start

Invoke the reflection skill to analyze the current task status and identify any pain points.

Frequently Asked Questions about reflection

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

FAQPage Schema
How do I perform root cause analysis when my AI agent is stuck on a coding problem?

Root cause analysis for task stagnation is performed by invoking a metacognitive reflection process that honestly assesses goals, progress, and costs to identify why the failure occurred. It distills lessons learned into actionable principles to prevent future mistakes.

What is metacognitive reflection and how does it help with task management?

Metacognitive reflection is a deep self-assessment of task status, user sentiment, and systemic issues. It helps task management by detecting architectural decay or repeated errors, analyzing root causes, and logging evolutionary principles to refine future problem-solving approaches.

How do I recover AI task context and plan a path forward after prolonged stagnation?

To recover context after stagnation, perform a deep reflection on detected pain points and systemic issues. This process outlines a clear recovery planning path forward while ensuring context is preserved and logging refined principles to avoid similar stalls.

When should I trigger a deep reflection to address user frustration and task stalls?

Trigger a deep reflection during scenarios of context compaction, prolonged task stagnation, repeated errors, or user dissatisfaction. It detects these specific pain points and performs an honest self-assessment to identify direct and root causes for the detected issues.

Does this problem-solving approach work for analyzing architectural decay and systemic issues?

Yes, this problem-solving approach works for architectural decay and systemic issues by performing a deep metacognitive reflection. It assesses current progress against initial goals, dives deep into the root causes of detected pain points, and distills lessons into actionable principles.

Can I use this reflection process to distill lessons learned into actionable principles?

Yes, you can use this reflection process to distill lessons learned into actionable principles. It performs evolutionary logging that records failures and refines principles, enabling AI evolution and preventing similar mistakes during future problem-solving tasks.