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.
Install
/plugin marketplace add Freddy-CHEN-ux/00_claude_skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add Freddy-CHEN-ux/00_claude_skills --skill understanding-mistakesgit 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-mistakesPersonal 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:
Details
- Skill name
understanding-mistakes- Repository
- Freddy-CHEN-ux/00_claude_skills
- 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
8Freddy-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.
AI Agents
8Freddy-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 LLM
8Freddy-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.
Update Langfuse Staging Server Prompt
8Freddy-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).
System Architect
5catch-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.
Acting
5GAGAA-HUE/ASHUO-claude-skills
角色表演系统——专为 AI 视频生成(Seedance 2.0)设计的角色行为/表演指导系统。 核心理念:表演是压力下的行为,而非情绪展示。将角色的目标、障碍、策略、 节拍变化、潜台词分解为可观察的身体语言和微表情。擅长:角色动机设计、 情绪节奏控制、非语言行为描述、反应时序、身体状态锚定。触发词:角色表演、 演技设计、角色行为、表演指导、acting、character performance、emotional beats。
Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.