learn

Review, search, prune, and export project learnings stored across gstack sessions.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/Simon-YHKim/eject-button --skill learn-simon-yhkim
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: learn
Source: https://github.com/Simon-YHKim/eject-button/tree/main/.claude/skills/learn
Command: npx skills add https://github.com/Simon-YHKim/eject-button --skill learn-simon-yhkim

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Knowledge discovered during past coding sessions (patterns, pitfalls, architecture decisions) gets lost when sessions end. This Skill manages a persistent learnings store so you can recall what was learned, find past fixes, and clean up stale or contradictory entries. ## Core Features & Use Cases - Show and search learnings: List the 20 most recent learnings grouped by type, or search by keyword across the project's learnings.jsonl store. - Prune stale entries: Detect learnings referencing deleted files or contradicting each other, then remove or update them interactively. - Export and stats: Export learnings as a Markdown section for CLAUDE.md or documentation, and view deduplicated counts by type, source, and average confidence. - Use Case: You hit a bug and think "didn't we fix this before?" Run a search to surface the prior learning with its insight and confidence score instead of re-debugging from scratch. ## Quick Start Ask the assistant to show what gstack has learned on this project, or to search learnings for a specific topic like authentication or build failures.

Frequently Asked Questions about learn

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

FAQPage Schema
How do I see what learnings were captured in past sessions?

Run the learn skill with no arguments to show the 20 most recent learnings grouped by type. Learnings are stored per project in a learnings.jsonl file under the gstack home directory and are loaded automatically at session start.

How do I search past project learnings for a specific topic?

Use the search command with a query string, for example "/learn search auth timeout". It runs gstack-learnings-search with your query and returns up to 20 matching entries with their keys, insights, and confidence scores.

Can I export learnings to CLAUDE.md or project documentation?

Yes. The export command formats up to 50 learnings as a Markdown section grouped by patterns, pitfalls, preferences, and architecture. You can then append it to CLAUDE.md or save it as a standalone file.

How does pruning detect stale or conflicting learnings?

Pruning checks each learning's referenced files against the repo and flags entries pointing to deleted files as stale. It also flags entries sharing the same key but with contradictory insights, then asks you to remove, keep, or update each one.

Does the learn skill modify project code?

No. It has a hard gate against implementing code changes and only manages the learnings store. The only project file it may touch is CLAUDE.md, and only if you approve adding routing rules or exported learnings.