learn

Manage project learnings in a markdown knowledge base across sessions.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/RavitejaKarra24/dotfiles --skill learn-ravitejakarra24
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: learn
Source: https://github.com/RavitejaKarra24/dotfiles/tree/main/agents/.agents/skills/learn
Command: npx skills add https://github.com/RavitejaKarra24/dotfiles --skill learn-ravitejakarra24

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams lose hard-won insights between sessions: patterns get rediscovered, pitfalls get hit twice, and preferences are forgotten. This Skill maintains a persistent, human-readable knowledge base of project learnings so past decisions and fixes stay searchable. ## Core Features & Use Cases - Review and Search: Show the 20 most recent learnings or search entries by keyword across patterns, pitfalls, preferences, architecture, and tools. - Prune and Maintain: Detect stale entries whose referenced files no longer exist and resolve contradictory entries with user confirmation. - Export and Stats: Format learnings for CLAUDE.md or a standalone file, and view summary statistics like counts, top sources, and average confidence. - Use Case: After debugging a tricky CPI signer issue, the pitfall is recorded with confidence score and file references; weeks later you can ask what was learned before re-encountering the same bug. ## Quick Start Ask the assistant to show what we have learned on this project so far.

Frequently Asked Questions about learn

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

FAQPage Schema
How do I search past project learnings across sessions?

Run the learn search command with a keyword query. It matches case-insensitively across entry keys, insights, sources, and file fields, then displays matching entries grouped by type such as patterns or pitfalls.

How do I export project learnings to CLAUDE.md?

Use the learn export command, which formats all entries into a clean markdown section. You then choose to append it to CLAUDE.md, save it as a standalone file, or print it without saving.

Can other skills write learnings automatically?

Yes. Other skills append entries to .superstack/learnings.md under the correct type section using the standard format with key, insight, confidence, source, files, and date. Duplicate keys are appended, and the latest entry wins.

How are stale or contradictory learnings handled?

The prune command checks whether files referenced by each entry still exist and flags contradictions between entries. Each flagged entry is presented for removal, keeping, or updating, and nothing is changed without confirmation.

Does the learn skill modify project code?

No. The skill is explicitly read/write for the learnings file only and never modifies project code. Its non-negotiable rules require append-only edits and user confirmation before changing existing entries.