# update-agent-learnings

The update-agent-learnings skill turns one confirmed lesson from a session into lasting agent guidance and syncs it to relevant agent files. Use it when a behavior rule should carry over to future sessions.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 160 installs · ★ 5 repo stars
- Author: ulpi-io
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ulpi-io/skills/tree/HEAD/update-agent-learnings/SKILL.md
- Updated: 2026-08-31
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/update-agent-learnings

## What it does

The skill identifies one actionable rule from the current session, assigns it a scope, and asks the user to approve the wording and files before making changes. Once approved, it updates the central learnings file and copies the regenerated `## Learnings` section to the agent definitions it finds. The central file remains the single source of truth.

It is meant for persistent agent behavior guidance, such as testing practices or rules for a particular role. It does not handle one-off implementation notes, workflow rules for `CLAUDE.md`, or requests to rewrite an agent prompt immediately. Because the workflow changes durable prompts, it will not write anything without explicit user approval. `Claude Code Only` rules stay in the central file and are excluded from subagent prompts.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill update-agent-learnings -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill update-agent-learnings -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill update-agent-learnings -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ulpi-io/skills update-agent-learnings
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill update-agent-learnings -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/ulpi-io/skills --path update-agent-learnings
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill update-agent-learnings -a opencode
```

### 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/ulpi-io/skills/tree/HEAD/update-agent-learnings/SKILL.md

## When to use it
- Store one validated agent-behavior rule
- Classify a lesson as global or agent-specific
- Sync `## Learnings` to the relevant agent files
- Keep `Claude Code Only` guidance out of subagent prompts

## Example prompts
- Save the lesson from this session about when to run tests, and show me the wording first.
- Record this rule for the `reviewer` agent and sync the matching agent files.
- Check whether this belongs in persistent agent guidance, then ask before editing anything.

## Similar
- [create-agent](https://affpapa.org/en/nevibecode/skills/create-agent.md) — skill · 1300 installs
- [gsd-extract-learnings](https://affpapa.org/en/nevibecode/skills/gsd-extract-learnings.md) — skill · 577 installs
- [compound-learnings](https://affpapa.org/en/nevibecode/skills/compound-learnings.md) — skill · 511 installs
- [session-learnings](https://affpapa.org/en/nevibecode/skills/session-learnings.md) — skill · 115 installs
- [replay-learnings](https://affpapa.org/en/nevibecode/skills/replay-learnings.md) — skill · ★ 2966 repo stars
- [extract-learnings](https://affpapa.org/en/nevibecode/skills/extract-learnings.md) — skill · ★ 276 repo stars

From the same set: [ulpi-io/skills](https://affpapa.org/en/nevibecode/by/ulpi-io/skills.md) — 49 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
