# Learn > Creates a new skill or updates an existing skill to capture new knowledge. Use when you want Claude to remember patterns, workflows, or project-specific guidance. - Skill: `tomevault-io/learn-4` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/learn-4` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/learn-4/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/learn-4 --- # Learning New Knowledge ## Overview Capture knowledge into reusable skills that persist across conversations. This can include: - Project-specific patterns and conventions - Workflow guidance for common tasks - Technology-specific knowledge for this codebase - Best practices discovered during development ## The Process **1. Understand what to learn:** - Ask the user what knowledge they want to capture - If invoked with context from the current conversation, identify the key insights - Determine if this should be a new skill or an update to an existing one - If existing skill is outdated, remove outdated information **2. Find or create the right skill:** - List existing skills in `.claude/skills/` - If the knowledge fits an existing skill, prepare to update it - If it's a new domain, create a new skill directory **3. Write the skill content:** Structure the skill with: - Clear, actionable guidance - Code examples where relevant - Common patterns and anti-patterns - When to use this knowledge **4. Validate with the user:** - Show the proposed skill content - Ask if anything should be added or changed - Confirm before writing ## Skill File Format Skills live in `.claude/skills//SKILL.md`: ```markdown --- name: skill-name description: Brief description shown in skill list. Explains when this skill should be activated. --- # Skill Title ## Overview What this skill covers and when to use it. ## Key Content The actual guidance, patterns, examples, etc. ``` ## Guidelines - **Keep skills focused** - One skill per domain/topic - **Be specific to this project** - Generic knowledge doesn't need a skill - **Include examples** - Show, don't just tell - **Update over improve** - Prefer updating existing skills over creating overlapping ones - **Descriptive names** - Skill names should clearly indicate their purpose --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/mikotoio) — claim your Tome and manage your conversions.