learn

A command that reviews the current coding session and extracts reusable solutions, debugging methods, workarounds, or project patterns into a proposed skill file.

In plain words
What is it for?
Use it after solving a non-trivial, reusable problem to identify what happened, why it worked, when the pattern applies, and how to document it. It asks for confirmation before saving.
Why use it?
It helps preserve useful lessons from one session so they can be applied again instead of being forgotten or rediscovered.

Command for Claude Code

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 commands/cfrs2005/claude-init/learn
Clone the repo
git clone --depth 1 https://github.com/cfrs2005/claude-init

Made for: Claude Code.

Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 522 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.00000 $0.00522
Opus 5 $0.00000 $0.00261
Sonnet 5 $0.00000 $0.00104
Haiku 4.5 $0.00000 $0.00052

Measured 2d ago against content hash 9ee0ea626d78, 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.

templates/.claude/commands/learn.md · 71 lines

What it actually says

/learn - 提取可复用模式

分析当前会话并提取任何值得保存为技能的模式。

触发条件

当你在会话中解决了一个非主要问题时,随时运行 /learn

提取内容

寻找:

  1. 错误解决模式

    • 发生了什么错误?
    • 根本原因是什么?
    • 怎么修复的?
    • 这对类似错误是否可复用?
  2. 调试技巧

    • 那些不明显的调试步骤
    • 起作用的工具组合
    • 诊断模式
  3. 变通方案 (Workarounds)

    • 库的怪癖
    • API 限制
    • 特定版本的修复
  4. 项目特定模式

    • 发现的代码库约定
    • 做出的架构决策
    • 集成模式

输出格式

~/.claude/skills/learned/[pattern-name].md 创建技能文件:

# [Descriptive Pattern Name] ([描述性模式名称])

**Extracted:** [Date] (**提取日期:** [日期])
**Context:** [Brief description of when this applies] (**上下文:** [适用情况简介])

## Problem (问题)
[What problem this solves - be specific] ([这也解决了什么问题 - 具体说明])

## Solution (解决方案)
[The pattern/technique/workaround] ([模式/技巧/变通方案])

## Example (示例)
[Code example if applicable] ([代码示例,如果适用])

## When to Use (何时使用)
[Trigger conditions - what should activate this skill] ([触发条件 - 什么应该激活此技能])

流程

  1. 审查会话以查找可提取的模式
  2. 识别最有价值/可复用的见解
  3. 起草技能文件
  4. 保存前请用户确认
  5. 保存到 ~/.claude/skills/learned/

注意事项

  • 不要提取微不足道的修复(拼写错误、简单的语法错误)
  • 不要提取一次性问题(特定 API 中断等)
  • 专注于能为未来会话节省时间的模式
  • 保持技能专注 - 每个技能一个模式
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 · 71 lines · 0 tokens per session scan A 9ee0ea626d78

Subscribe to this mod's changes

learn is a command published in the GitHub repository cfrs2005/claude-init (1,364 stars, last pushed 5mo ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 522 tokens. 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-30.