Skip to main content
skill CX Codex

save-learning — Claude Code skill: what it does, how to install

save-learning turns a user's lasting preferences into project learnings. Use it when an agent should carry a rule from one session into the next.

MIT ★ 1,319 updated 2026-09-24

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add caliber-ai-org/ai-setup --skill save-learning -a claude-code
Open on GitHub

What save-learning does

When a user asks the agent to retain a rule, the skill rewrites it as a concise, actionable note and assigns a category such as preference, convention, or anti-pattern. It presents that note for approval before making any change.

Once approved, the skill runs caliber learn add. Personal preferences use the --personal flag, and the skill stages CALIBER_LEARNINGS.md for a later commit. A one-off request should not become a lasting project rule, so the skill filters those out.

What it helps with

  • carry a project convention into later sessions
  • turn a stated preference into an actionable note
  • stage the learnings file for a commit

Example prompts for the agent

  • Remember this for the project: use bun instead of npm for packages.
  • Save this preference for future sessions: avoid any in TypeScript.
  • From now on, send feature commits to next, not master.

How to install save-learning

1Skills CLI (Vercel)

npx skills add caliber-ai-org/ai-setup --skill save-learning -a claude-code

2Manually: put the files in place

~/.claude/skills/save-learning/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/save-learning/

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

Questions about save-learning

How do I install save-learning in Claude Code?

Run npx skills add caliber-ai-org/ai-setup --skill save-learning -a claude-code. The skill file is located at ~/.claude/skills/save-learning/SKILL.md.

What does save-learning do?

It turns lasting user instructions into categorized notes, asks for approval, then saves approved notes with caliber learn add and stages CALIBER_LEARNINGS.md.

How are personal preferences saved?

The skill passes --personal to caliber learn add when the note is a personal preference rather than a project-level learning.

Source text

SKILL.md · MIT
---
name: save-learning
description: Saves user instructions as persistent learnings for future sessions. Use when the user says 'remember this', 'always do X', 'from now on', 'never do Y', or gives any instruction they want persisted across sessions. Proactively suggest when the user states a preference, convention, or rule they clearly want followed in the future.
---

# Save Learning

Save a user's instruction or preference as a persistent learning that
will be applied in all future sessions on this project.

## Instructions

1. Detect when the user gives an instruction to remember, such as:
   - "remember this", "save this", "always do X", "never do Y"
   - "from now on", "going forward", "in this project we..."
   - Any stated convention, preference, or rule
2. Refine the instruction into a clean, actionable learning bullet with
   an appropriate type prefix:
   - `**[convention]**` — coding style, workflow, git conventions
   - `**[pattern]**` — reusable code patterns
   - `**[anti-pattern]**` — things to avoid
   - `**[preference]**` — personal/team preferences
   - `**[context]**` — project-specific context
3. Show the refined learning to the user and ask for confirmation
4. If confirmed, run:
   ```bash
   caliber learn add "<refined learning>"
   ```
   For personal preferences (not project-level), add `--personal`:
   ```bash
   caliber learn add --personal "<refined learning>"
   ```
5. Stage the learnings file for the next commit:
   ```bash
   git add CALIBER_LEARNINGS.md
   ```

## Examples

User: "when developing features, push to next branch not master, remember it"
-> Refine: `**[convention]** Push feature commits to the \`next\` branch, not \`master\``
-> "I'll save this as a project learning:
    **[convention]** Push feature commits to the \`next\` branch, not \`master\`
    Save for future sessions?"
-> If yes: run `caliber learn add "**[convention]** Push feature commits to the next branch, not master"`
-> Run `git add CALIBER_LEARNINGS.md`

User: "always use bun instead of npm"
-> Refine: `**[preference]** Use \`bun\` instead of \`npm\` for package management`
-> Confirm and save

User: "never use any in TypeScript, use unknown instead"
-> Refine: `**[convention]** Use \`unknown\` instead of \`any\` in TypeScript`
-> Confirm and save

## When NOT to trigger

- The user is giving a one-time instruction for the current task only
- The instruction is too vague to be actionable
- The user explicitly says "just for now" or "only this time"

© caliber-ai-org · MIT · caliber-ai-org/ai-setup

Similar skills

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

From the same set17

The whole set →
scoring-patterns scoring-patterns defines coding rules for the src/scoring/** directory. It keeps scoring checks deterministic without external network calls or random values. CX Codex +1 ★ 1,319repo stars llm-patterns The llm-patterns rule sets patterns for LLM providers in a project. Use it when provider interfaces, model settings, CLI errors, or streamed responses need consistent handling. CX Codex +1 ★ 1,319repo stars caliber-pre-commit caliber-pre-commit — a commit-time rule: it checks for the Caliber git hook and, when the hook is absent, syncs and stages your agent config files. CX Codex +1 ★ 1,319repo stars find-skills find-skills discovers community skills from the Caliber registry and installs them directly into your coding session. CX Codex +1 ★ 1,319repo stars setup-caliber setup-caliber walks a project through Caliber setup: installs the CLI, hooks agent config sync into every commit, and creates the config files your agents are missing. CX Codex +1 ★ 1,319repo stars adding-a-command adding-a-command generates Commander.js CLI commands in src/commands/, connects them to src/cli.ts, and sets up telemetry tracking. CX Codex +1 ★ 1,319repo stars llm-provider The llm-provider skill guides you through adding an LLM backend to a project, from its provider class to configuration and factory registration. Use it when connecting a third-party API or another model. CX Codex +1 ★ 1,319repo stars scoring-checks Adds deterministic scoring checks that measure AI agent config quality. Evaluates file structure, standards compliance, and configuration patterns — with no randomness or external calls. CX Codex +1 ★ 1,319repo stars

Project sponsors

Companies that keep this analytics open