# Capture Learnings

Capture and apply accumulated knowledge via structured memory.

- Repository: https://github.com/BuilderIO/agent-native (7579 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add BuilderIO/agent-native --skill capture-learnings -g -a claude-code -y`
Codex: `npx skills add BuilderIO/agent-native --skill capture-learnings -g -a codex -y`
Cursor: `npx skills add BuilderIO/agent-native --skill capture-learnings -g -a cursor -y`
Gemini CLI: `npx skills add BuilderIO/agent-native --skill capture-learnings -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add BuilderIO/agent-native`

## Description

Capture and apply accumulated knowledge via structured memory. Use when the user gives feedback, shares preferences, corrects a mistake, or when you discover something worth remembering for future conversations.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Capture Learnings

This is background knowledge, not a slash command. **Organization learnings and your personal memory index are loaded at the start of every conversation, including Slack/integration turns.** Capture durable context proactively when you learn something worth remembering.

## How to Read & Write Memories

Memories are stored as **resources** in the SQL database, not as files on disk.

- **Team/organization knowledge:** shared `LEARNINGS.md`. Read it first, merge the new fact, then write the full updated file with the `resources` tool using `scope: "shared"`. Shared scope resolves to the active organization; it must never leak to another organization in the same deployment.
- **Personal knowledge:** `memory/MEMORY.md` plus `memory/<name>.md`, written with `save-memory`.

- **Save a memory:** `save-memory --name <name> --type <type> --description "..." --content "..."`
- **Read a memory:** `resource-read --path memory/<name>.md`
- **Delete a memory:** `delete-memory --name <name>`
- **List all memories:** `resource-list --prefix memory/`

## Memory Types

| Type | Use for |
|------|---------|
| `user` | Preferences, role, personal context, contacts |
| `feedback` | Corrections, confirmed approaches, things to avoid or repeat |
| `project` | Ongoing work context, decisions, deadlines, status |
| `reference` | Pointers to external systems, URLs, API details |

## When to Capture

Follow the user's personal `memory/INSTRUCTIONS.md` when deciding what to
preserve or leave out. It is loaded automatically with the user's personal
`AGENTS.md` instructions.

At the natural stopping point of a meaningful multi-turn task, review the
conversation for durable preferences, corrections, decisions, conventions, or
project context that would improve a future thread. Save only new, supported
facts; completed task details and temporary debugging notes stay in the thread.

The rest: https://github.com/BuilderIO/agent-native/blob/HEAD/.agents/skills/capture-learnings/SKILL.md