update-claude-learnings — Claude Code skill: what it does
The update-claude-learnings skill turns one confirmed observation about Claude Code into a project rule in CLAUDE.md. It checks placement and asks before changing persistent memory.
no license 162 installs ★ 5 updated 2026-08-31
npx skills add ulpi-io/skills --skill update-claude-learnings -a claude-codeWhat update-claude-learnings does
Use the skill to carry a specific Claude Code workflow lesson from the current session into the project’s CLAUDE.md. It covers rules about workflow, task boundaries, and session handling. Application implementation notes, subagent guidance, and skill-authoring practices belong elsewhere.
Before editing, it looks for similar guidance, picks a fitting section, and presents the proposed wording for approval. Once approved, it makes a focused change while retaining the file’s structure, then checks the result. It will not write to CLAUDE.md without explicit user consent, so adding a rule always requires a deliberate confirmation.
What it helps with
- carry a Claude Code workflow lesson into future sessions
- choose a suitable
CLAUDE.mdsection for a new rule - check existing guidance before adding a similar instruction
- approve the wording before changing project memory
Example prompts for the agent
- Record in
CLAUDE.mdthat you should ask before extending a bug fix into nearby refactoring. - Review
CLAUDE.mdand suggest a section for a rule about session checkpoints. - Save this observation about Claude Code in
CLAUDE.md, but show me the wording and wait for approval first.
How to install update-claude-learnings
1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill update-claude-learnings -a claude-code2Manually: put the files in place
~/.claude/skills/update-claude-learnings/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/update-claude-learnings/
1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill update-claude-learnings -a codex2Manually: put the files in place
.agents/skills/update-claude-learnings/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill update-claude-learnings -a cursor2Manually: put the files in place
.cursor/skills/update-claude-learnings/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ulpi-io/skills update-claude-learnings2Manually: put the files in place
.github/skills/update-claude-learnings/SKILL.md1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill update-claude-learnings -a gemini-cli2Platform CLI
gemini skills install https://github.com/ulpi-io/skills --path update-claude-learningsManually: put the files in place
.devin/skills/update-claude-learnings/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill update-claude-learnings -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about update-claude-learnings
How do I install update-claude-learnings in Claude Code?
Run npx skills add ulpi-io/skills --skill update-claude-learnings -a claude-code. The skill file is located at ~/.claude/skills/update-claude-learnings/SKILL.md.
What does update-claude-learnings do?
It helps add one verified Claude Code behavior rule to a project’s CLAUDE.md. It checks for similar guidance, proposes a section, and waits for explicit approval before editing.
Can I use it to record application coding conventions?
No. This skill is for project-specific Claude Code workflow behavior; application implementation guidance should go in agent instruction files.