Understanding Mistakes

Use when user says something went wrong, AI did Y instead of X, or wants to understand why a deviation happened. Manually invoked post-mortem analysis.

8 stars 3 forksAI, LLMs & Agents Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add Freddy-CHEN-ux/00_claude_skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add Freddy-CHEN-ux/00_claude_skills --skill understanding-mistakes
Manual install
git clone --depth 1 https://github.com/Freddy-CHEN-ux/00_claude_skills.git /tmp/00_claude_skills
mkdir -p ~/.claude/skills
cp -r /tmp/00_claude_skills/skills/understanding-mistakes ~/.claude/skills/understanding-mistakes

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Understanding Mistakes

## Overview

Analyze why you deviated from expected behavior. Produce honest self-reflection and document learnings to prevent the same mistake twice.

## Process

**1. Gather Context**

If the issue isn't clear, ask the user:
- "What did you expect to happen?"
- "What actually happened?"

**2. Self-Reflect**

Analyze your own decision-making honestly:
- What information did I have access to?
- What assumptions did I make?
- Why did I choose this approach over the expected one?
- Did I ignore explicit guidance? Why?

**3. Identify the Gap**

Determine root cause:
- Missing information in the instruction?
- Ambiguous wording I interpreted differently?
- Over-engineering instinct?
- Default behavior overriding explicit guidance?
- Assumed I knew better?

**4. Write Learning Document**

Create `docs/learnings/YYYY-MM-DD-<topic>.md` with this structure:
Read the full skill on GitHub

Details

Skill name
understanding-mistakes
Path
skills/understanding-mistakes/SKILL.md
Repo updated
10 January 2026

FAQ

What does the Understanding Mistakes skill do?

Use when user says something went wrong, AI did Y instead of X, or wants to understand why a deviation happened. Manually invoked post-mortem analysis.

How do I install the Understanding Mistakes skill?

Claude Code plugin: /plugin marketplace add Freddy-CHEN-ux/00_claude_skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Understanding Mistakes popular?

It lives in Freddy-CHEN-ux/00_claude_skills, which has 8 GitHub stars and 3 forks.

Related skills

Add Integration

8

Freddy-CHEN-ux/00_claude_skills

Build a new API integration for Nexus. Load when user mentions "add integration", "new integration", "integrate with", "connect to [service]", or "build [service] integration". Interactive workflow that discovers API endpoints, plans the integration, and creates a project for implementation.

Software Development

AI Agents

8

Freddy-CHEN-ux/00_claude_skills

Production-grade AI agent patterns with MCP integration, agentic RAG, handoff orchestration, multi-layer guardrails, and observability (modern best practices)

AI, LLMs & Agents

AI LLM

8

Freddy-CHEN-ux/00_claude_skills

Production LLM engineering skill. Covers strategy selection (prompting vs RAG vs fine-tuning), dataset design, PEFT/LoRA, evaluation workflows, deployment handoff to inference serving, and lifecycle operations with cost/safety controls.

AI, LLMs & Agents

Update Langfuse Staging Server Prompt

8

Freddy-CHEN-ux/00_claude_skills

Push prompt updates to Langfuse (staging or production). Defaults to STAGING (safe). Production requires explicit --production flag + confirmation. NEVER assigns labels (human-in-the-loop safety).

AI, LLMs & Agents

System Architect

5

catch-the-wave/fullstack-ios-claude-skills

Backend architecture, API design, and ML/AI systems expertise. Use for API design, data flows, ML pipelines, embeddings, vector databases, or architectural decisions. Researches best practices via Perplexity when uncertain.

AI, LLMs & Agents

Acting

5

GAGAA-HUE/ASHUO-claude-skills

角色表演系统——专为 AI 视频生成(Seedance 2.0)设计的角色行为/表演指导系统。 核心理念:表演是压力下的行为,而非情绪展示。将角色的目标、障碍、策略、 节拍变化、潜台词分解为可观察的身体语言和微表情。擅长:角色动机设计、 情绪节奏控制、非语言行为描述、反应时序、身体状态锚定。触发词:角色表演、 演技设计、角色行为、表演指导、acting、character performance、emotional beats。

AI, LLMs & Agents

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.