Skip to main content
skill CX Codex

learning-from-mistakes · syahiidkamil — Claude Code skill: logs bugs

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.

no license ★ 406 updated 2026-06-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add syahiidkamil/Software-Engineer-AI-Agent-Atlas --skill learning-from-mistakes -a claude-code
Open on GitHub

What learning-from-mistakes 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.

What it helps with

  • 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 for the agent

  • 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

How to install learning-from-mistakes

1Skills CLI (Vercel)

npx skills add syahiidkamil/Software-Engineer-AI-Agent-Atlas --skill learning-from-mistakes -a claude-code

2Manually: put the files in place

~/.claude/skills/learning-from-mistakes/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/learning-from-mistakes/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about learning-from-mistakes

How to install learning-from-mistakes in Claude Code?

Run npx skills add syahiidkamil/Software-Engineer-AI-Agent-Atlas --skill learning-from-mistakes -a claude-code, and the skill will land in ~/.claude/skills/learning-from-mistakes/SKILL.md.

What does the learning-from-mistakes skill do?

It writes a bug or mistake into a file after resolution: symptom, cause, fix, and lesson. The agent creates an entry on its own when a bug proved hard or surprising.

When does the agent create an entry?

When a bug resisted solving and required developer guidance, or when debugging took a long time and ended in a non-obvious insight. Routine fixes are not recorded.

Similar skills

All skills for Agent setup: memory, context, orchestration →

learning-from-mistakes by other authors comes first.

learning-from-mistakes oxbshw learning-from-mistakes turns your corrections of video answers into stored lessons, so later answers on similar questions get better. Also shows what has been saved. CX Codex +1 728installs learning-capturer Mario Aldayuz / Littlebird The learning-capturer skill mines your Littlebird session history to find moments where you debugged and fixed an error. CX Codex +1 ★ 96repo stars skill-from-book bmad-labs The skill-from-book Claude Code skill turns a Markdown book into an organized knowledge package for an AI agent. It plans topic files, extracts material, and proposes repeatable workflows. CX Codex +1 183installs learning-vault glebis learning-vault builds a structured Markdown study vault for certifications or research topics. Generates atomic concepts, review tasks, and learning maps tailored to your confidence levels. CX Codex +1 108installs self-learning philschmid self-learning is a Claude Code skill that researches technologies on the web and turns documentation into a reusable skill. Run /learn <topic> or ask it to investigate an unfamiliar library, framework, or tool. CX Codex +1 3,400installs session-learning-capture davila7 session-learning-capture is a Claude Code command that saves session insights to project memory. Choose project knowledge, implementation fixes, structure notes, or workflow improvements. CX Codex +1 425installs iterate-lessons-log product-on-purpose iterate-lessons-log writes a structured lessons learned entry after an incident or a finished project. Useful when the knowledge has to outlive the team that earned it. CX Codex +1 810installs

From the same set26

The whole set →
commit Runs a background subagent to commit staged Git changes following ATLAS conventions. Useful when you want automated commits without blocking your session. CX Codex +1 ★ 406repo stars stage-commit The stage-commit command hands working-directory changes to a background commit subagent. Use it to create grouped commits and keep going until Git reports a clean tree. CX Codex +1 ★ 406repo stars log log inspects recent git commits, summarizes their themes, and maps them against uncommitted changes in your working tree. CX Codex +1 ★ 406repo stars create-test-cases create-test-cases drafts browser-focused manual test cases in Markdown for a project feature or area. Use it to prepare cases for /qa:manual-test-run. CX Codex +1 ★ 406repo stars wireframe The wireframe command renders a static low-fidelity screen layout into a single HTML file — gray boxes, dashed borders, no libraries. Opens with a double-click. CX Codex +1 ★ 406repo stars commit Creates Git commits autonomously using ATLAS conventions without asking for approval. Handles staged files or splits working changes into clean commits. CX Codex ★ 406repo stars abstraction-power The abstraction-power skill guides Claude Code from concrete code examples to reusable models by spotting their shared structure. Use it to examine duplicated logic or shape a system design. CX Codex +1 ★ 406repo stars get-to-know get-to-know is a Claude Code command that initializes project context by gathering stack, structure, and conventions, creating a project map, and configuring the environment. CX Codex +1 ★ 406repo stars

Project sponsors

Companies that keep this analytics open