learn

A workflow for turning articles, documentation, or code repositories into proposed improvements to an agent's skills and rules.

In plain words
What is it for?
Use it after adding references or when you provide a web address to fetch and analyse. It extracts the main content and proposes updates.
Why use it?
It avoids leaving useful research as unprocessed notes by connecting new material directly to concrete changes.

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

Made for: Claude Code, Codex.

Per session 38 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,838 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.00038 $0.01838
Opus 5 $0.00019 $0.00919
Sonnet 5 $0.00008 $0.00368
Haiku 4.5 $0.00004 $0.00184

Measured 2d ago against content hash 62fd59cfab49, 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 · 109 lines

How it starts

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

Process new material from .claude/references/ and propose concrete changes to skills and rules. No intermediate knowledge files — findings route directly to actionable proposals.

URL ingestion (when $ARGUMENTS is a URL)

If $ARGUMENTS starts with http:// or https://, treat it as a URL to ingest:

  1. WebFetch the URL and extract the main content (article text, README, docs — skip nav/ads/boilerplate)
  2. Generate a slug from the page title or URL path (e.g. claude-code-best-practices.md)
  3. Write the extracted content as markdown to references/blogs/<slug>.md
  4. Log: "Saved → references/blogs/.md"
  5. Continue to the processing steps below — the new file will be picked up as unprocessed

This bridges the scout-learn pipeline: /scout produces "Worth investigating" URLs, and /learn <url> ingests them directly.

Idempotency rule — filesystem-based, read this first

Processed state is tracked on the filesystem — do NOT rely on the index table for deduplication:

  • Blog files: physically moved to a processed/ subfolder
  • Repo directories: marked with an empty processed/.done file inside the repo dir (too large to move)
  1. Scan the filesystem for unprocessed candidate items:
    • references/blogs/ — every file directly in this folder (NOT inside processed/)
    • references/repos/ — every subdirectory that does NOT have a processed/ marker file inside it (i.e., references/repos/<dir>/processed/.done does not exist)
    • Ignore references/index.md and any processed/ subfolders
  2. If there are no new items, skip to Skill review below.

Processing steps (only for unprocessed items)

For blog/article files (individual files in references/blogs/):

  1. Read the full content. For PDF files, use the pages parameter to read in chunks of 20 pages (e.g. pages: "1-20", then pages: "21-40") — do not attempt to read an entire large PDF at once.
  2. Extract only actionable, durable insights — skip opinions, anecdotes, and general knowledge Claude already has
  3. For each insight, map it to a concrete change target:
    • A specific skill file (.claude/skills/<name>/SKILL.md) — what line/section to change
    • A rule file (.claude/rules/<name>.md) — create new or update existing
    • CLAUDE.md — if it's a project-wide convention
    • If an insight doesn't map to any file, discard it — it's not actionable
  4. Tag each insight with the affected skills: **Affects:** [skill1, skill2]
  5. Immediately after processing, move the file into the processed/ subfolder: references/blogs/processed/<filename>

Read the full file on GitHub · 109 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 · 109 lines · 38 tokens per session scan A 62fd59cfab49

Subscribe to this mod's changes

learn is a skill published in the GitHub repository dixus/claudeframework (10 stars, last pushed 4mo ago), licensed MIT. It adds 38 tokens to every session and 1,838 once invoked, about $0.0002 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.