Skip to main content
skill CX Codex

update-agent-learnings — Claude Code skill: installation

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.

no license 160 installs ★ 5 updated 2026-08-31

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ulpi-io/skills --skill update-agent-learnings -a claude-code
Open on GitHub

What update-agent-learnings 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.

What it helps with

  • 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 for the agent

  • 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.

How to install update-agent-learnings

1Skills CLI (Vercel)

npx skills add ulpi-io/skills --skill update-agent-learnings -a claude-code

2Manually: put the files in place

~/.claude/skills/update-agent-learnings/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/update-agent-learnings/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about update-agent-learnings

How do I install update-agent-learnings in Claude Code?

Run npx skills add ulpi-io/skills --skill update-agent-learnings -a claude-code. The skill file is installed at ~/.claude/skills/update-agent-learnings/SKILL.md.

What does update-agent-learnings do?

It extracts one agent-behavior rule from a session, confirms its wording and scope with the user, then updates the central learnings file and relevant agent definitions.

Does the skill edit agent files without approval?

No. It requires the user's explicit approval before changing the central learnings file or any agent file.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set49

The whole set →
codemap This skill uses the codemap CLI to search code by intent and inspect repository dependencies. Use it to locate symbols or investigate how files relate. CX Codex +1 167installs branch-review-before-pr branch-review-before-pr reviews a branch diff against the default base and reports merge-stopping defects before the PR exists. Edits nothing until you approve a fix. CX Codex +1 167installs nodejs A reference skill that makes the agent follow your project's own Node.js or Bun backend conventions instead of generic defaults. CX Codex +1 163installs update-claude-learnings 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. CX Codex +1 162installs map-project-monorepo map-project-monorepo builds self-contained CLAUDE.md files for every monorepo member and keeps the project root minimal. CX Codex +1 160installs commit Creates targeted git commits from working diffs, checks for secrets and conflict markers, and stages files individually by name. CX Codex +1 159installs git-merge-expert-worktree git-merge-expert-worktree — a Claude Code skill that runs merges and conflict resolution inside a dedicated git worktree. The main tree stays clean, and the skill handles its own cleanup when the operation finishes. CX Codex +1 159installs create-pr create-pr opens a GitHub pull request from the real branch diff: commits pending work first, runs the narrowest checks, pushes, then creates and verifies the PR with gh. CX Codex +1 156installs

Project sponsors

Companies that keep this analytics open