Skip to main content
skill CX Codex

10-learn — Claude Code skill: capture and formalize project knowledge

10-learn — a skill for Claude Code, Cursor, and other platforms that records decisions, conventions, lessons, and code review findings as durable project knowledge.

MIT ★ 571 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-context@aidd-framework
Open on GitHub

What 10-learn does

10-learn works in five steps: identify the knowledge source (conversation, file, diff, review), extract candidates for capture, score and reconcile them, show the list for approval, then write approved learnings or hand off to other tools, and refresh memory references. Each step touches only the files it needs—no unnecessary copies, no rewrites of completed work.

Unlike generic note-taking, it filters for durable knowledge: decisions that affect future decisions, team conventions, recurring pitfalls to avoid, proven workflows worth automating. Skips temporary notes, individual preferences, or one-time remarks. Output lands in architecture decision records (ADRs), IDE rules, or new skills depending on scope.

What it helps with

  • record a decision or convention so it won't be forgotten or overturned by accident
  • extract lessons from a code review or diff—what broke, how to guard against it, what to change in process
  • capture a workflow that already works and turn it into an IDE rule or skill
  • gather candidates for new rules from conversations, docs, or pull requests and evaluate them together

Example prompts for the agent

  • Capture the mistakes we made in this review and how to prevent them next time
  • Write down the order we decided to build components in this project
  • Extract the three most important findings from this diff and add them to our project knowledge base

How to install 10-learn

1Plugin marketplace

/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-context@aidd-framework

This installs the whole aidd-context plugin with all its skills

2Skills CLI (Vercel)

npx skills add ai-driven-dev/framework --skill 10-learn -a claude-code

3Manually: put the files in place

~/.claude/skills/10-learn/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/10-learn/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about 10-learn

How do I install 10-learn in Claude Code?

Run npx skills add ai-driven-dev/framework --skill 10-learn -a claude-code in your terminal, then open ~/.claude/skills/10-learn/SKILL.md. For marketplace installation, add the source first: /plugin marketplace add ai-driven-dev/framework, then /plugin install aidd-context@aidd-framework.

What does 10-learn do?

It reads a source (conversation, file, diff, or code review), extracts candidates for capture—decisions, lessons, conventions, pitfalls—shows them to you for approval, then either saves them to project memory or hands them off to an IDE rule or new skill.

When does 10-learn hand off a finding to a rule or skill instead of project memory?

When the finding deserves more: if it's a workflow that repeats in every commit or review, or a rule that should be checked automatically. For temporary notes, individual preferences, or one-time remarks, the skill is not the right fit.

Source text

SKILL.md · MIT
---
name: 10-learn
description: Capture durable project learnings. Use when the user wants to remember, record, or formalize a decision, convention, lesson, pitfall, reusable workflow, or review finding. Not for preferences or temporary notes.
argument-hint: conversation | file | diff | review
---
# Learn

```mermaid
flowchart LR
  source --> gather --> assess --> write
  source -->|"missing, empty, or ambiguous"| sourceStop([stop])
  gather -->|"no candidates"| gatherEnd([end])
  assess -->|"all covered"| assessEnd([end])
  write -->|"memory or ADR"| sync
  write -->|"rule or skill"| handoff([handoff])
  sync -->|"failure"| syncStop([stop])
```

## Actions

Run the flow above. Read only the next action file.

| Action | Does |
| ------ | ---- |
| source | identify and challenge the origin |
| gather | read the origin and extract candidates |
| assess | score, reconcile, show, and confirm |
| write | write or hand off approved lessons |
| sync | refresh memory references |

## Transversal rules

- Write only the user-approved plan.
- Preserve user edits and touch affected files only.
- Write project files only, never personal or global memory.

© AI-Driven Dev · MIT · ai-driven-dev/framework

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set80

The whole set →
05-improve 05-improve examines conversation logs, evaluates visible token usage, and suggests targeted refinements without touching your code. CX Codex +1 ★ 571repo stars 1-documentation The 1-documentation rule guides edits to project Markdown: it keeps decisions and useful commands while removing repetition and temporary records. It applies to selected files and folders. CX Codex +1 ★ 571repo stars 03-prd 03-prd turns a need, idea or brainstorm into a structured product requirements document: a draft from a template, saved only once you approve it. CX Codex +1 ★ 571repo stars 08-three-amigos 08-three-amigos evaluates epics and user stories through product, delivery, or quality perspectives, then reconciles three separate reports before backlog edits. CX Codex +1 ★ 571repo stars 10-task 10-task — a skill that takes one bounded backlog task through framing, review and a final save. Reach for it when a piece of delivery work needs writing down, linking, ordering or closing. CX Codex +1 ★ 571repo stars 05-review 05-review inspects git diffs or implementation plans to confirm changes are ready to ship, pairing every issue with a fix. CX Codex +1 ★ 571repo stars 01-brainstorm The 01-brainstorm skill clarifies a rough idea through questions, then turns the discussion into a short brief. Use it when a request is ambiguous or you want to explore an idea together. CX Codex +1 ★ 571repo stars 3-cli-process 3-cli-process sets the conventions for a CLI process: how it shuts down, which channel gets which output, and what exit code it returns. CX Codex +1 ★ 571repo stars

Project sponsors

Companies that keep this analytics open