# Learn

> Capture an observation — something that went wrong or worked well — to LEARNINGS.md for future reference. Quick in-session capture, not full analysis.

- Skill: `isvlasov/learn` (Agent Skill)
- Install (CLI): `npx skillmds@latest add isvlasov/learn`
- Raw SKILL.md: https://api.skillmd.com/api/skills/isvlasov/learn/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: isvlasov (https://skillmd.com/u/isvlasov)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/isvlasov/learn

---


# Learn

Capture an observation to `LEARNINGS.md` so it is preserved for future sessions and later `/codify` sweeps.

This is **quick capture, not analysis** — root cause analysis happens later, when the user runs `/codify`. Record what happened clearly enough that a future reader can understand it without this session's context.

## Steps

1. **Locate or create `LEARNINGS.md`** in the project root. If it does not exist, create it using the LEARNINGS.md template in the scaffolding-project skill (current frontmatter format lives there).
2. **Draft the entry from session context.** With no arguments, the user is signalling "that was noteworthy — record it": draft your best understanding and ask "Here's what I'd capture — does this match how you see it?". With an argument, fold the user's pointer or perspective into the draft. Either way you write the entry; the user confirms or corrects — they should not have to explain the event from scratch.
3. **Append the entry** following the format in the file's frontmatter comment. Distil, do not transcribe.
4. **Confirm** — tell the user what was recorded and where. Nothing else needed.