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
/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-context@aidd-frameworkWhat 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-frameworkThis 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-code3Manually: put the files in place
~/.claude/skills/10-learn/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/10-learn/
1Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 10-learn -a codex2Manually: put the files in place
.agents/skills/10-learn/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 10-learn -a cursor2Manually: put the files in place
.cursor/skills/10-learn/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ai-driven-dev/framework plugins/aidd-context/skills/10-learn2Manually: put the files in place
.github/skills/10-learn/SKILL.md1Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 10-learn -a gemini-cli2Platform CLI
gemini skills install https://github.com/ai-driven-dev/framework --path plugins/aidd-context/skills/10-learnManually: put the files in place
.devin/skills/10-learn/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 10-learn -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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