# update-skill-learnings

update-skill-learnings captures one validated rule about skill design or quality in a central learnings file. Use it when a session reveals guidance worth keeping.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 155 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-skill-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-skill-learnings

## What it does

This skill turns one session finding into a small rule about skill structure, content, quality, or a skill-specific design choice. It routes application-code and agent-behavior guidance away from skill memory, then places the learning under Structural Patterns, Content Patterns, Anti-Patterns, or Skill-Specific Learnings.

The workflow checks for duplicates, resolves the canonical learnings file, and prepares the wording before any edit. Depending on the repository layout, the target can be `.agents/learnings/skill-learnings.md` or `.claude/learnings/skill-learnings.md`.

After approval, it adds the single learning, preserves the document structure, and verifies the result. The durable learnings file is not changed until the user explicitly approves the wording and placement.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill update-skill-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-skill-learnings/SKILL.md

## When to use it
- capture a skill-structure rule
- turn a session finding into an anti-pattern
- check a proposed learning for duplicates
- place guidance in the right category

## Example prompts
- Run `/update-skill-learnings` and extract one durable skill-authoring rule from this session.
- Use `/update-skill-learnings` to record this anti-pattern in the central skill-learnings file.
- Invoke `/update-skill-learnings` with a focus on skill quality, then ask me to approve the wording before writing.

## Similar
- [gsd-extract-learnings](https://affpapa.org/en/nevibecode/skills/gsd-extract-learnings.md) — skill · 577 installs
- [open-knowledge-write-skill](https://affpapa.org/en/nevibecode/skills/open-knowledge-write-skill.md) — skill · 6900 installs
- [skill-authoring](https://affpapa.org/en/nevibecode/skills/skill-authoring.md) — skill · 4300 installs
- [create-skill](https://affpapa.org/en/nevibecode/skills/neolabhq-create-skill.md) — skill · 1300 installs
- [maplibre-skill-authoring](https://affpapa.org/en/nevibecode/skills/maplibre-skill-authoring.md) — skill · 229 installs
- [creating-skills](https://affpapa.org/en/nevibecode/skills/creating-skills.md) — skill · 208 installs

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
