learn

Manages a project learnings knowledge base stored in a markdown file across sessions.

1|Updated May 10, 2026
One-click install
npx skills add https://github.com/goheesheng/base-new --skill learn-goheesheng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: learn
Source: https://github.com/goheesheng/base-new/tree/main/skills/idea/learn
Command: npx skills add https://github.com/goheesheng/base-new --skill learn-goheesheng

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 at .superstack/learnings.md so patterns, pitfalls, preferences, architecture decisions, and tool choices survive across sessions. ## Core Features & Use Cases - Review and search learnings: Show the 20 most recent entries or search by keyword across keys, insights, sources, and files. - Prune and maintain quality: Detect stale entries whose referenced files no longer exist and contradictory entries, then remove, keep, or update them with user confirmation. - Export and statistics: Format learnings for CLAUDE.md or a standalone file, and view summary stats like entry counts, top source skill, and average confidence. - Use Case: After a debugging session uncovers that CPI calls require PDA signer seeds, the pitfall is recorded with a confidence score; weeks later you can run a search before touching settlement code and avoid repeating the mistake. ## Quick Start Ask the assistant to show what has been learned on this project so far, or to record a new learning about a pattern you just discovered.

Frequently Asked Questions about learn

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

FAQPage Schema
How do I save project learnings across AI coding sessions?

Use the learn skill to append entries to `.superstack/learnings.md`, a markdown file grouped by patterns, pitfalls, preferences, architecture, and tools. Each entry records an insight, confidence score, source skill, relevant files, and date.

How do I search past project decisions and patterns?

Run `/learn search <query>` to perform a case-insensitive search across entry keys, insights, sources, and file paths. Matching entries are displayed grouped by type, and `/learn stats` shows what has been recorded overall.

Can learnings be exported to CLAUDE.md?

Yes, `/learn export` formats all entries into a clean markdown section and lets you append it to the project's CLAUDE.md, save it as a standalone file, or print it without saving.

How are stale or contradictory learnings handled?

The `/learn prune` command checks whether files referenced by each entry still exist and flags contradictions between entries. You confirm each flagged entry as remove, keep, or update before any change is written.

Does the learn skill modify my project code?

No, the skill is read/write for the learnings file only and never modifies project code. All removals or edits to existing entries require explicit user confirmation first.