learning-capture

Capture durable learnings and route them to the correct memory home.

9|2|Updated Jun 6, 2026
One-click install
npx skills add https://github.com/app-vitals/shipwright --skill learning-capture-app-vitals
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: learning-capture
Source: https://github.com/app-vitals/shipwright/tree/main/plugins/shipwright/skills/learning-capture
Command: npx skills add https://github.com/app-vitals/shipwright --skill learning-capture-app-vitals

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you preserve durable user learnings instead of forgetting them after a single turn. It prevents one-off corrections from polluting long-term memory and keeps reusable guidance in the right home.

Core Features & Use Cases

  • Generalization Gate: Checks whether a correction applies to future work or is only task-specific.
  • Correct Memory Routing: Decides whether to write to project memory, user memory, a plugin skill, or a Harness TODO.
  • Skill and CLAUDE Editing: Captures standing rules, preferences, and non-obvious workflow knowledge directly in the appropriate file.
  • Use Case: A user says to always use one tool, avoid a workflow, or remember a recurring preference, and the Skill records it where future sessions can reuse it.

Quick Start

Use the learning-capture skill to record a durable correction in the correct memory home after confirming it generalizes.

Frequently Asked Questions about learning-capture

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

FAQPage Schema
How do I save recurring preferences in CLAUDE.md so Claude Code remembers them?

To save recurring preferences in CLAUDE.md, the learning-capture skill records durable corrections directly in the appropriate file. It applies a generalization gate to ensure the preference applies to future work before writing it to project or user memory.

What's the best way to persist workflow knowledge across different Claude Code sessions?

The best way to persist workflow knowledge across sessions is using learning-capture, which routes reusable guidance to the correct memory home. It distinguishes standing instructions from reusable skills and records them where future sessions can access them.

How does generalization gate logic filter one-off corrections from long-term memory?

The generalization gate checks whether a correction applies to future work or is only task-specific. It prevents one-off corrections from polluting long-term memory by only capturing generalizable corrections and recurring preferences.

Can I route durable learnings to different memory scopes like project and plugin memory?

Yes, learning-capture routes durable learnings to the correct memory home across project, user, plugin, and agent scopes. It decides whether to write to project memory, user memory, a plugin skill, or Harness TODO notes based on the learning type.

When should I not use learning capture for saving instructions?

You should not use learning capture for task-specific corrections that do not generalize to future work. The skill enforces a generalization gate to filter out one-off instructions, preventing them from polluting long-term memory files.

Does learning-capture check for duplicate entries when writing to CLAUDE.md or skill files?

Yes, learning-capture performs duplication checks before recording edits in CLAUDE.md, skill files, or Harness TODO notes. This ensures durable learnings and standing rules are not written multiple times across memory homes.