Agent skill

Save Learning

by caliber-ai-org in caliber-ai-org/ai-setup

Saves user instructions as persistent learnings for future sessions.

MITAuto-check passed

Install Save Learning

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

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install caliber-ai-org/ai-setup save-learning --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/caliber-ai-org/ai-setup.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/save-learning .claude/skills/save-learning && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
save-learning
GitHub stars
1.3k
Token cost
~626 tokens
SKILL.md length
269 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

Saves user instructions as persistent learnings for future sessions.

  • Works in 5 steps: Detect when the user gives an… → Refine the instruction into a clean,… → Show the refined learning to the user… → …
  • The user says remember this
  • SKILL.md covers Instructions, Examples and When NOT to trigger
  • Calls git

What it does

Save Learning is an agent skill from caliber-ai-org/ai-setup. 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.

Its SKILL.md is about 630 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Continuously sync your AI setups with one command. Codebase tailor suited agent skills, MCPs and config files for Claude Code, Cursor, and Codex. The licence is MIT.

When your agent uses it

  • The user says remember this
  • Gives any instruction they want persisted across sessions
  • States a preference
  • Rule they clearly want followed in the future

Example prompts

  • “remember this”
  • “always do X”
  • “from now on”
  • “/save-learning”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Detect when the user gives an instruction to remember, such as
  2. Refine the instruction into a clean, actionable learning bullet with
  3. Show the refined learning to the user and ask for confirmation
  4. If confirmed, run
  5. Stage the learnings file for the next commit

What it can do on your machine

Read from SKILL.md and the folder at commit f5dbc00. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Save Learning loads about 626 tokens when it runs. Until then it costs about 86 tokens; SKILL.md has 269 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~86
When it runs · the whole SKILL.md, loaded when a task matches
~626

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from caliber-ai-org/ai-setup at commit f5dbc00, republished under its MIT licence (© caliber-ai-org). 269 words, ~626 tokens.

Download SKILL.mdSave it as .claude/skills/save-learning/SKILL.md (or your agent's skills folder).
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. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/save-learning of caliber-ai-org/ai-setup.

Open the folder on GitHubat commit f5dbc00

Compare with similar skills

Save Learning next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Save Learning compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Save Learning this skillcaliber-ai-org/ai-setup1.3k—~626Automated safety check: PassMIT
Session Persistruvnet/ruflo74k—~415Automated safety check: NotesMIT
Learning to Learn (OpenMAIC)THU-MAIC/OpenMAIC40k—~502Automated safety check: PassMIT
Project Learnings Managergarrytan/gstack136k—~8.2kAutomated safety check: NotesMIT
Context Savegarrytan/gstack136k—~9.8kAutomated safety check: NotesMIT
Learn From Sessiontigerless-labs/autoharness9.2k—~280Automated safety check: PassMIT

Similar skills

  • Session Persist

    ruvnet/ruflo

    Persist and restore agent sessions across conversations with state snapshots

    74k GitHub stars~415 tokensUpdated today
    Auto-check: notes
  • A Chinese-language skill that embeds learning strategies like retrieval practice and self-explanation as a parallel goal inside an OpenMAIC subject lesson, without making study skills the topic.

    40k GitHub stars~502 tokensUpdated today
    EducationAuto-check passed
  • Lets you review, search, prune and export the learnings gstack has collected across sessions, and surfaces them when a past fix or pattern comes up.

    136k GitHub stars~8.2k tokensUpdated today
    Agent WorkflowsAuto-check: notes
  • Context Save

    garrytan/gstack

    Captures git state, decisions made and remaining work so that a later session can resume the task without losing context.

    136k GitHub stars~9.8k tokensUpdated today
    Agent WorkflowsAuto-check: notes
  • Learn From Session

    tigerless-labs/autoharness

    Use when the user says /learn or asks to save this lesson.

    9.2k GitHub stars~280 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Scikit Learn

    K-Dense-AI/scientific-agent-skills

    Supports machine learning in Python with scikit-learn. An agent skill from K-Dense-AI/scientific-agent-skills.

    48k GitHub starsUsed in 1 repo~3.3k tokens
    Data & AnalyticsAuto-check: notes

More from caliber-ai-org/ai-setup

All 8 skills in this repo
  • Adding A Command

    caliber-ai-org/ai-setup

    Creates a new CLI command following the Commander.js pattern in src/commands/.

    1.3k GitHub stars~2k tokensUpdated 14 days ago
    Auto-check passed
  • Caliber Testing

    caliber-ai-org/ai-setup

    Writes Vitest tests following project patterns: tests/ directories, vi.mock() for module mocking with vi.hoisted() for test-time factories, global LLM mock from src/test/setup.ts, environment…

    1.3k GitHub stars~3.2k tokensUpdated 14 days ago
    Auto-check passed
  • Find Skills

    caliber-ai-org/ai-setup

    Discovers and installs community skills from the public registry.

    1.3k GitHub stars~593 tokensUpdated 14 days ago
    Auto-check passed
  • LLM Provider

    caliber-ai-org/ai-setup

    Adds a new LLM provider implementing LLMProvider interface with call() and stream() methods.

    1.3k GitHub stars~2.7k tokensUpdated 14 days ago
    Auto-check passed
  • Scoring Checks

    caliber-ai-org/ai-setup

    Add a new deterministic scoring check in src/scoring/checks/ that evaluates config quality.

    1.3k GitHub stars~3k tokensUpdated 14 days ago
    Auto-check passed
  • Setup Caliber

    caliber-ai-org/ai-setup

    Sets up Caliber for automatic AI agent context sync. An agent skill from caliber-ai-org/ai-setup.

    1.3k GitHub stars~1.9k tokensUpdated 14 days ago
    Auto-check passed

Questions about Save Learning

What does Save Learning do?

Saves user instructions as persistent learnings for future sessions. Save Learning is an agent skill from caliber-ai-org/ai-setup. Saves user instructions as persistent learnings for future sessions.

When should I use Save Learning?

Save Learning fits situations like: the user says remember this; gives any instruction they want persisted across sessions; states a preference; rule they clearly want followed in the future.

How do I install Save Learning in Claude Code?

Run `npx skills add caliber-ai-org/ai-setup --skill save-learning -a claude-code`. Or copy the skill folder (skills/save-learning in caliber-ai-org/ai-setup) into .claude/skills/save-learning in your project. Claude Code loads it when a task matches its description.

How do I install Save Learning in Codex?

Run `npx skills add caliber-ai-org/ai-setup --skill save-learning -a codex`. Or copy the skill folder (skills/save-learning in caliber-ai-org/ai-setup) into .agents/skills/save-learning in your project. Codex loads it when a task matches its description.

Can I use Save Learning in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add caliber-ai-org/ai-setup --skill save-learning -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/save-learning, .gemini/skills/save-learning, .github/skills/save-learning and .opencode/skills/save-learning in your project.

What does Save Learning need to run?

Going by SKILL.md and its folder, Save Learning needs the command-line tools its instructions call (git).

Does Save Learning access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Save Learning safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Save Learning use?

Save Learning is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Save Learning use?

About 626 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Save Learning?

Skills that share tags, products or a category with Save Learning: Session Persist (ruvnet/ruflo, 74k stars), Learning to Learn (OpenMAIC) (THU-MAIC/OpenMAIC, 40k stars), Project Learnings Manager (garrytan/gstack, 136k stars) and Context Save (garrytan/gstack, 136k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Save Learning?

caliber-ai-org (a GitHub organization) maintains it in caliber-ai-org/ai-setup, which has 1,300 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on September 24, 2026.

Source: caliber-ai-org/ai-setup on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.