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
npx skills add ulpi-io/skills --skill update-skill-learnings -a claude-codeWhat 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-learningsand extract one durable skill-authoring rule from this session. - Use
/update-skill-learningsto record this anti-pattern in the central skill-learnings file. - Invoke
/update-skill-learningswith 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-code2Manually: put the files in place
~/.claude/skills/update-skill-learnings/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/update-skill-learnings/
1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill update-skill-learnings -a codex2Manually: put the files in place
.agents/skills/update-skill-learnings/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill update-skill-learnings -a cursor2Manually: put the files in place
.cursor/skills/update-skill-learnings/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ulpi-io/skills update-skill-learnings2Manually: put the files in place
.github/skills/update-skill-learnings/SKILL.md1Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill update-skill-learnings -a gemini-cli2Platform CLI
gemini skills install https://github.com/ulpi-io/skills --path update-skill-learningsManually: put the files in place
.devin/skills/update-skill-learnings/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ulpi-io/skills --skill update-skill-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-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.