learn

A project-memory helper that records useful lessons from development work. It saves what went wrong, what fixed it, and what to check next time.

In plain words
What is it for?
Use it to record lessons about failed tests, compile errors, unexpected APIs, or mistaken assumptions. The notes are kept in shared project memory files.
Why use it?
It prevents the same debugging detours and incorrect assumptions from being repeated. It is also used automatically after work needs more than one fix cycle.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/alexmond/jhelm/learn
Any agent
npx skills add alexmond/jhelm --skill learn
Clone the repo
git clone --depth 1 https://github.com/alexmond/jhelm

Made for: Claude Code, Codex.

Per session 100 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,130 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00100 $0.01130
Opus 5 $0.00050 $0.00565
Sonnet 5 $0.00020 $0.00226
Haiku 4.5 $0.00010 $0.00113

Measured 2d ago against content hash 833e43d27200, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

learn scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/learn/SKILL.md · 104 lines

How it starts

The opening of the file, as written. The whole thing — 104 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Save a learning to project memory

$ARGUMENTS

Determine the learning

If triggered automatically (multi-cycle resolution), synthesise the learning from the conversation:

  • What was the root cause of the extra cycle(s)?
  • What assumption or gap in knowledge caused the first attempt to fail?
  • What is the correct approach / API / behaviour?
  • What should be checked first next time to avoid the same detour?

If triggered by the user, record exactly what they stated in $ARGUMENTS.

Steps

  1. Read the current memory file: /Users/alex.mondshain/.claude/projects/-Users-alex-mondshain-claude-jhelm/memory/MEMORY.md

  2. Check whether a relevant topic file already exists in that same directory (e.g. dependencies.md, testing.md, debugging.md). If so, read it too.

  3. Decide where to write:

    • Short, self-contained insight that fits an existing MEMORY.md section → add it there (keep file ≤ 200 lines).
    • Detailed or topic-specific learning → append to or create a dedicated topic file, then add/update a one-line reference in MEMORY.md.
  4. Write in concise, actionable form:

    • Bullet points, not prose.
    • Lead with what to do / what to check, follow with why.
    • If it supersedes an existing note, update or remove the old one.
  5. Scan for reusable scripts (see section below).

  6. Confirm to the user what was saved and where (one line is enough).

What to save

  • Root causes of multi-cycle failures and the correct fix
  • Non-obvious library behaviours or API quirks discovered during the task
  • Version constraints and compatibility issues (e.g. BCrypt prefix $2y$ vs $2a$)
  • Architectural decisions and their rationale
  • Workflow or tool preferences the user has stated
  • Patterns confirmed to work that aren't obvious from the code
  • Platform-specific shell/CLI argument failures — save to the ## macOS / Platform-Specific Shell Quirks section in MEMORY.md with the failing invocation and the correct macOS alternative

Read the full file on GitHub · 104 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 104 lines · 100 tokens per session scan A 833e43d27200

Subscribe to this mod's changes

learn is a skill published in the GitHub repository alexmond/jhelm (4 stars, last pushed 8d ago), licensed Apache-2.0. It adds 100 tokens to every session and 1,130 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

ai-article

AI 类文章撰写。三种风格:安装教程、产品评测、面试八股。覆盖 AI Coding 工具实测、AI 开发框架应用、大模型测评、Agent/Skills/RAG 技术讲解。.

itwanger/toBeBetterJavaer · 57 tokens

book-mirror

Take any book (EPUB/PDF), produce a personalized chapter-by-chapter analysis. Each chapter is preserved in detail (The Chapter) and mirrored back to the reader's actual life (The Mirror) using brain context. The mirror observes and resonates — a friend pointing out parallels, NOT a consultant rearranging the reader's…

garrytan/gbrain · 138 tokens

ljg-learn

Deep concept anatomist that deconstructs any concept through 8 exploration dimensions (history, dialectics, phenomenology, linguistics, formalization, existentialism, aesthetics, meta-philosophy) and compresses insights into an epiphany. Use when user asks to explain, dissect, or deeply understand a concept, term, or…

lijigang/ljg-skills · 113 tokens

eli5

Explain research, papers, or technical ideas in plain English with minimal jargon, concrete analogies, and clear takeaways. Use when the user says "ELI5 this", asks for a simple explanation of a paper or research result, wants jargon removed, or asks what something technically dense actually means.

companion-inc/feynman · 63 tokens

deck-course-module

暖纸背景 + Playfair, 左侧学习目标常驻, 含 MCQ 自测页.

nexu-io/html-anything · 25 tokens

pedagogy-review

Holistic pedagogical review of a lecture deck (.qmd or .tex). Checks narrative arc, prerequisite assumptions, worked examples, notation clarity, and deck-level pacing. Use when user says "pedagogy review", "does this teach well?", "is the flow right?", "will students follow?", "review the narrative", or before…

pedrohcgs/claude-code-my-workflow · 90 tokens