# extract-learnings

extract-learnings is a Claude Code skill that saves project knowledge and keeps memory notes organized. Record a finding or consolidate existing notes.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 276 repo stars
- Author: Samarth Gupta
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-memory/skills/extract-learnings/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/extract-learnings

## What it does

For a one-off note, the skill checks existing memory for duplicates and chooses a suitable layer. During consolidation, it gathers context from memory files, `CLAUDE.md` and Git history, then runs a memory auditor alongside an agent that looks for new signals. If `MEMORY.md` does not exist yet, the skill creates it and skips the audit agent.

The memory hierarchy separates general preferences, project rules, short working notes and detailed topic files. `MEMORY.md` loads in every session; supporting details can be opened when needed. When a section grows beyond its limit, its pointers move to a cluster file. L2 and L3 notes live under the user's `~/.claude` directory, so they are not shared with teammates. Project-wide rules belong in `<repo>/CLAUDE.md`.

The skill reads project memory and runs `git log --oneline -20`. Consolidation uses the `claude-memory:memory-auditor` and `claude-memory:signal-discoverer` subagents; with a new, empty memory, only the signal-finding agent runs. That distinction matters if you expect an audit of existing notes.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add gupsammy/Claudest
```
In the agent chat (not a shell):
```text
/plugin install claude-memory@Claudest
```
This installs the whole claude-memory plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill extract-learnings -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill extract-learnings -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill extract-learnings -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install gupsammy/Claudest plugins/claude-memory/skills/extract-learnings
```

2. **Manually: put the files in place**
- File: `.github/skills/extract-learnings/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill extract-learnings -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/gupsammy/Claudest --path plugins/claude-memory/skills/extract-learnings
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/extract-learnings/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/gupsammy/Claudest/tree/HEAD/plugins/claude-memory/skills/extract-learnings/SKILL.md

## When to use it
- save project findings for later sessions
- find duplicate or outdated memory notes
- sort knowledge into the project's memory layers
- move detailed references out of the always-loaded index

## Example prompts
- Remember this project’s build order for future sessions and save it in the right memory layer.
- Consolidate project memory and identify notes that should be merged or retired.
- Review recent project changes and record recurring findings for later sessions.

## Similar
- [gsd-extract-learnings](https://affpapa.org/en/nevibecode/skills/gsd-extract-learnings.md) — skill · 577 installs
- [replay-learnings](https://affpapa.org/en/nevibecode/skills/replay-learnings.md) — skill · ★ 2966 repo stars
- [save-session-learnings](https://affpapa.org/en/nevibecode/commands/save-session-learnings.md) — command · ★ 1424 repo stars
- [compound-learnings](https://affpapa.org/en/nevibecode/skills/compound-learnings.md) — skill · 511 installs
- [update-claude-learnings](https://affpapa.org/en/nevibecode/skills/update-claude-learnings.md) — skill · 162 installs
- [update-agent-learnings](https://affpapa.org/en/nevibecode/skills/update-agent-learnings.md) — skill · 160 installs

From the same set: [gupsammy/claudest](https://affpapa.org/en/nevibecode/by/gupsammy/claudest.md) — 47 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
