save-learning

Capture user instructions as structured learnings and stage CALIBER_LEARNINGS.md.

1.2k|119|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/caliber-ai-org/ai-setup --skill save-learning-caliber-ai-org
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: save-learning
Source: https://github.com/caliber-ai-org/ai-setup/tree/main/.cursor/skills/save-learning
Command: npx skills add https://github.com/caliber-ai-org/ai-setup --skill save-learning-caliber-ai-org

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Persist user instructions and preferences as learnings that the AI applies across sessions, reducing repetitive setup and mistakes.

Core Features & Use Cases

  • Detect when a user asks to remember or persist a preference (e.g., "remember this", "from now on") and refine it into a structured learning.
  • Propose a clear action with a type prefix (e.g., [convention], [pattern], [anti-pattern], [preference], [context]) and request confirmation before saving.
  • Save the refined learning via caliber learn add, with an option for personal vs project-wide scope, and stage CALIBER_LEARNINGS.md for the next commit.

Quick Start

Tell me to remember a preference and I will save it as a persistent learning for future sessions.

Frequently Asked Questions about save-learning

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I persist user instructions and preferences across sessions?

You can persist user instructions by expressing a lasting preference, which the system refines into a structured learning with a type prefix and saves for future sessions. It classifies the instruction, requests explicit confirmation, and stages the update to CALIBER_LEARNINGS.md.

How does remembering a convention or preference work with type prefixes?

Remembering a convention works by proposing a clear action with a type prefix like [convention], [pattern], [anti-pattern], [preference], or [context]. The system requests explicit confirmation before saving the refined learning to ensure accuracy.

Can I save learnings at both personal and project-wide scope levels?

Yes, you can save learnings at either personal or project-wide scope levels. When adding a learning via the system command, you select the desired scope to ensure the instruction applies correctly to your future sessions.

What's the best way to stop repeating setup instructions in every session?

To stop repeating setup instructions, tell the system to remember a specific preference or convention. It captures the instruction as a persistent learning, reducing repetitive setup and preventing mistakes in future sessions.

When should I not use persistent learnings for context and preferences?

You should not use persistent learnings for temporary context or one-time instructions that should not apply to future sessions. They are designed exclusively for lasting instructions and preferences that need to persist across sessions.

Does saving a learning automatically update the CALIBER_LEARNINGS.md file?

Saving a learning stages updates to CALIBER_LEARNINGS.md for the next commit. It does not automatically commit the file, giving you control over when the staged changes are finalized in your version control system.