# learning-from-mistakes

learning-from-mistakes — a skill that writes a bug or mistake into a separate file after the problem is resolved. Captures the cause, fix, and lesson to avoid repeating the debugging work.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 406 repo stars
- Author: syahiidkamil
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/syahiidkamil/Software-Engineer-AI-Agent-Atlas/tree/HEAD/.claude/skills/learning-from-mistakes/SKILL.md
- Updated: 2026-06-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/syahiidkamil-learning-from-mistakes

## What it does

The skill generates a file `docs/learning-from-mistakes/<problem-name>.md` after a hard bug or long debugging session. It includes four sections: symptom (what looked wrong), root cause (why it actually happened), resolution (what fixed it), and lesson (how to avoid it next time). The agent writes an entry on its own when a bug resisted solving and required guidance from the developer, or when a debugging hunt took a long time and ended in a non-obvious realization.

Before declaring a bug unsolvable, the agent scans `docs/learning-from-mistakes/` — a past lesson may already name the cause. Routine fixes are skipped: the criterion is surprise. An entry is worth writing only if the cause would genuinely surprise someone, even in hindsight.

The skill works with the ATLAS repository (Software Engineer AI Agent), where the Claude Code agent manages the project. Entries accumulate locally, each as a separate file.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add syahiidkamil/Software-Engineer-AI-Agent-Atlas --skill learning-from-mistakes -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/learning-from-mistakes/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/learning-from-mistakes/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add syahiidkamil/Software-Engineer-AI-Agent-Atlas --skill learning-from-mistakes -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/learning-from-mistakes/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add syahiidkamil/Software-Engineer-AI-Agent-Atlas --skill learning-from-mistakes -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/learning-from-mistakes/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install syahiidkamil/Software-Engineer-AI-Agent-Atlas .claude/skills/learning-from-mistakes
```

2. **Manually: put the files in place**
- File: `.github/skills/learning-from-mistakes/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add syahiidkamil/Software-Engineer-AI-Agent-Atlas --skill learning-from-mistakes -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/syahiidkamil/Software-Engineer-AI-Agent-Atlas --path .claude/skills/learning-from-mistakes
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/learning-from-mistakes/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/syahiidkamil/Software-Engineer-AI-Agent-Atlas/tree/HEAD/.claude/skills/learning-from-mistakes/SKILL.md

## When to use it
- capture a non-obvious bug cause after debugging
- preserve a lesson to avoid repeating the same mistake
- check past bugs before giving up on a problem

## Example prompts
- Write a lesson from this bug into `learning-from-mistakes`
- Scan `docs/learning-from-mistakes/` — we might have hit this before
- Create an entry for this issue: symptom was timezone shifting the date by one day

## Similar
- [learning-capturer](https://affpapa.org/en/nevibecode/skills/learning-capturer.md) — skill · ★ 96 repo stars
- [skill-from-book](https://affpapa.org/en/nevibecode/skills/skill-from-book.md) — skill · 183 installs
- [learning-vault](https://affpapa.org/en/nevibecode/skills/learning-vault.md) — skill · 108 installs
- [self-learning](https://affpapa.org/en/nevibecode/skills/self-learning.md) — skill · 3400 installs
- [session-learning-capture](https://affpapa.org/en/nevibecode/commands/session-learning-capture.md) — command · 425 installs
- [iterate-lessons-log](https://affpapa.org/en/nevibecode/skills/iterate-lessons-log.md) — skill · 810 installs

## Other versions with the same name
- [learning-from-mistakes · oxbshw](https://affpapa.org/en/nevibecode/skills/learning-from-mistakes.md) — 728 installs

From the same set: [syahiidkamil/software-engineer-ai-agent-atlas](https://affpapa.org/en/nevibecode/by/syahiidkamil/software-engineer-ai-agent-atlas.md) — 26 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
