Ai-setup save-learning

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.

install

source · Clone the upstream repo

git clone https://github.com/caliber-ai-org/ai-setup

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/caliber-ai-org/ai-setup "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.agents/skills/save-learning" ~/.claude/skills/caliber-ai-org-ai-setup-save-learning && rm -rf "$T"

manifest: .agents/skills/save-learning/SKILL.md

source content

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

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
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
Show the refined learning to the user and ask for confirmation

If confirmed, run:

caliber learn add "<refined learning>"

For personal preferences (not project-level), add

--personal

caliber learn add --personal "<refined learning>"

Stage the learnings file for the next commit:

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"