learn

A knowledge compiler that turns findings from completed campaigns or improvement cycles into updates for an existing project wiki. It extracts patterns, decisions, and mistakes, then checks the result.

In plain words
What is it for?
Use it after a completed campaign or evolve cycle to update evidence, increase confidence in repeated patterns, flag contradictions, and run a lint-only check.
Why use it?
It helps future work benefit from proven lessons instead of leaving findings in separate campaign notes.

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/sethgammon/citadel/learn
Any agent
npx skills add SethGammon/Citadel --skill learn
Clone the repo
git clone --depth 1 https://github.com/SethGammon/Citadel

Made for: Claude Code, Codex.

Per session 66 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,012 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.00066 $0.03012
Opus 5 $0.00033 $0.01506
Sonnet 5 $0.00013 $0.00602
Haiku 4.5 $0.00007 $0.00301

Measured 3d ago against content hash 63c13d5e3fc5, 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 3d 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.

skills/learn/SKILL.md · 308 lines

How it starts

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

/learn — Knowledge Compiler

Orientation

Use when: You have a completed campaign or evolve cycle and want to compile its findings into the project's growing knowledge wiki — so future sessions start smarter, not from scratch.

Don't use when: You want a structured incident analysis first (use /postmortem — run it before /learn); you haven't finished any campaigns (nothing to compile); you want a context transfer only (use /session-handoff).

Key difference from appending: /learn doesn't create isolated per-campaign files. It integrates new findings into existing wiki pages — updating evidence lists, raising confidence where a pattern is confirmed again, and flagging contradictions. A wiki is a compiler; a log is an interpreter.

Invocation Forms

/learn                              — most recently completed campaign
/learn {slug}                       — specific campaign by slug
/learn {file-path}                  — specific campaign file path
/learn --from-evolve {target}       — compile from /evolve pattern library
/learn --from-evolve {target} --cycle {n}  — specific evolve cycle only
/learn --lint                       — lint-only pass (no new extraction)
/learn --compile                    — re-compile staging area into wiki (no new extraction)
/learn --memory                     — compile semantic memory blocks from planning artifacts
/learn --doc-sync                   — process doc-sync queue into .planning/doc-sync/latest.md

Inputs

  1. A campaign slug, file path, evolve target, or "most recent" resolution
  2. Corresponding postmortem in .planning/postmortems/ (optional)
  3. .planning/telemetry/audit.jsonl filtered to this campaign (optional)
  4. For --from-evolve: .planning/evolve/{target}/pattern-library.md

Protocol

Step 1: RESOLVE TARGET

If /learn (no argument):

  • Glob .planning/campaigns/completed/*.md or .planning/campaigns/*.md where Status: completed
  • Sort by modification time descending, take most recent
  • If none found: "No completed campaigns found. Run /learn after a campaign completes." Stop.

Read the full file on GitHub · 308 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 3d ago First seen · 308 lines · 66 tokens per session scan A 63c13d5e3fc5

Subscribe to this mod's changes

learn is a skill published in the GitHub repository SethGammon/Citadel (914 stars, last pushed 5d ago), licensed MIT. It adds 66 tokens to every session and 3,012 once invoked, about $0.0003 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-30.

Related

Other skills, from other repositories

kungfu-agent-onboarding

Use when a user asks to understand, start, inspect, extend, or safely operate installed Kungfu; verify the installed pack, select one intent route, personalize the explanation, and propose one smallest safe next action.

kungfu-systems/kungfu · 49 tokens

llmtornado-tutorial-generator

Generates comprehensive code tutorials on LlmTornado API formatted for Medium publication with examples, explanations, and best practices.

lofcz/LLMTornado · 31 tokens

career-interview

한국 취준생·재직 이직자를 위한 면접 준비·모의 면접·답변 코칭 스킬입니다. "면접 준비해줘", "예상 질문 뽑아줘", "모의 면접 해줘", "팀핏 질문 대비"처럼 말하면 됩니다. AI 역량검사, 역량 면접(BEI), PT, 토론, 임원, 2026 팀핏 면접까지 유형별 대비 + 모의 면접 루프 (질문→답변→피드백) + 역질문 15종 + 화상/하이브리드 면접 가이드를 제공합니다.

modu-ai/moai-cowork · 142 tokens

zapier-demo

Walk a new user through setting up their first Zapier action and running it live — the smallest possible win. Asks what app they use, recommends one read action to enable, guides them to mcp.zapier.com to add it, then demonstrates it working in the same chat. Use when the user asks "show me how Zapier works", "set up…

zapier/zapier-mcp · 121 tokens

finance-econ-literacy

금리·환율·물가 같은 경제지표를 '내 돈' 관점에서 읽도록 도와주는 스킬입니다. '금리 오르면 어떻게 돼', '환율이 내 자산에 미치는 영향', '경제지표 읽는 법', 'GDP가 뭐야', '경기 사이클'처럼 말하면 됩니다. 금리·환율·물가(CPI)·GDP·고용·수출입 지표가 대출·예금·투자·소비에 어떻게 연결되는지 쉬운 언어로 설명합니다.

modu-ai/moai-cowork · 128 tokens

finance-invest-primer

투자를 처음 시작하는 사람에게 기본 원칙과 자산군, 초보 포트폴리오를 안내하는 스킬입니다. '투자 어떻게 시작해', '주식 초보', 'ETF가 뭐야', '분산투자 방법', '초보 포트폴리오 짜줘'처럼 말하면 됩니다. 분산·장기·리스크 관리 원칙, 자산군(주식/ETF/채권/부동산/예적금) 비교, 초보 포트폴리오, 투자 사기 회피를 한국 투자자 관점에서 설명합니다.

modu-ai/moai-cowork · 134 tokens