Skip to main content
skill CX Codex

update-skill-learnings — Claude Code skill: use and install

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.

no license 155 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-skill-learnings -a claude-code
Open on GitHub

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

What it helps with

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

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

How to install update-skill-learnings

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

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

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

Questions about update-skill-learnings

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

Run npx skills add ulpi-io/skills --skill update-skill-learnings -a claude-code, then check ~/.claude/skills/update-skill-learnings/SKILL.md.

What does update-skill-learnings do?

It stores one approved rule about skill design or quality in the central learnings file, while checking its category and possible duplicates. It does not rewrite an actual skill file.

Why does the skill ask for approval before editing?

The workflow changes durable skill-authoring guidance. The user must approve the wording, category, and target file first.

Similar skills

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

From the same set49

The whole set →
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 start start is a Claude Code skill that routes incoming tasks, selects domain skills, evaluates sub-agent delegation, and limits context exploration before code edits. CX Codex +1 152installs pr-retro The pr-retro skill measures a feature branch against its base and reports merge-readiness with recommendations. Run it before reviewing a PR. CX Codex +1 150installs ast-grep This skill uses the ast-grep CLI to find code by syntax. Use it when a text or regex search cannot express the structure you need. CX Codex +1 148installs browse-qa browse-qa is a skill that turns feature requests into explicit QA scenarios, runs them through browse, and saves stable flows for regression checks. CX Codex +1 148installs

Project sponsors

Companies that keep this analytics open