learn · pedrohcgs — скилл для Claude Code: что делает и как установить
Скилл learn для Claude Code сохраняет неочевидные решения и воркэраунды текущей сессии в постоянный файл. Переносит опыт долгой отладки в будущие сессии.
MIT ★ 1 729 обновлён 2026-09-27
npx skills add pedrohcgs/claude-code-my-workflow --skill learn -a claude-codeЧто делает learn
Скилл извлекает полученный в диалоге опыт и оформляет его в виде переиспользуемой инструкции. Работа идёт в четыре этапа: сначала агент оценивает пользу находки, затем ищет совпадения в папке .claude/skills/ через grep и ls. Если решение действительно новое или дополняет старое, создаётся файл SKILL.md с описанием проблемы, триггеров и шагов проверки.
Финальный этап включает контроль качества. Агент проверяет точность условий запуска, работоспособность решения и следит, чтобы в текст не попали пароли или персональные данные. Для работы скиллу нужны инструменты Read, Write, Bash, Glob и Grep.
Скилл сохраняет файл строго по шаблону с именем в формате kebab-case. Без доступа к файловой системе через Bash или Write записать результат он не сможет.
Какие задачи решает
- Зафиксировать неочевидное решение редкой ошибки для будущих сессий
- Проверить папку
.claude/skills/на дубликаты перед созданием нового скилла - Оформить пошаговый воркэраунд в шаблонный файл
SKILL.md - Исключить случайное попадание токенов и секретов в базу знаний
Примеры запросов агенту
- /learn fixest-missing-covariate-handling
- Мы разобрались с этой ошибкой, запусти /learn postgres-ssl-workaround
- Зафиксируй найденный порядок сборки через /learn docker-multi-stage-fix
Как установить learn
1Через Skills CLI (Vercel)
npx skills add pedrohcgs/claude-code-my-workflow --skill learn -a claude-code2Вручную: положить файлы
~/.claude/skills/learn/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/learn/
1Через Skills CLI (Vercel)
npx skills add pedrohcgs/claude-code-my-workflow --skill learn -a codex2Вручную: положить файлы
.agents/skills/learn/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add pedrohcgs/claude-code-my-workflow --skill learn -a cursor2Вручную: положить файлы
.cursor/skills/learn/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install pedrohcgs/claude-code-my-workflow .claude/skills/learn2Вручную: положить файлы
.github/skills/learn/SKILL.md1Через Skills CLI (Vercel)
npx skills add pedrohcgs/claude-code-my-workflow --skill learn -a gemini-cli2Командой платформы
gemini skills install https://github.com/pedrohcgs/claude-code-my-workflow --path .claude/skills/learnВручную: положить файлы
.devin/skills/learn/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add pedrohcgs/claude-code-my-workflow --skill learn -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о learn
Как установить learn в Claude Code?
Выполните команду npx skills add pedrohcgs/claude-code-my-workflow --skill learn -a claude-code. Также файл скилла можно положить вручную в ~/.claude/skills/learn/SKILL.md.
Что делает скилл learn?
Он анализирует контекст текущего диалога, находит удачные решения или воркэраунды и упаковывает их в файл формата SKILL.md с метаданными.
Куда сохраняются созданные навыки?
Скилл записывает новые файлы по пути .claude/skills/[skill-name]/SKILL.md, проверяя перед этим имя на соответствие kebab-case.
Исходный текст
SKILL.md · MIT
--- name: learn description: | Extract reusable knowledge from the current session into a persistent skill. Use when you discover something non-obvious, create a workaround, or develop a multi-step workflow that future sessions would benefit from. argument-hint: "[skill-name (kebab-case)]" allowed-tools: ["Read", "Write", "Bash", "Glob", "Grep"] disable-model-invocation: true metadata: author: Claude Code Academic Workflow version: 1.0.0 --- # /learn — Skill Extraction Workflow Extract non-obvious discoveries into reusable skills that persist across sessions. ## When to Use This Skill Invoke `/learn` when you encounter: - **Non-obvious debugging** — Investigation that took significant effort, not in docs - **Misleading errors** — Error message was wrong, found the real cause - **Workarounds** — Found a limitation with a creative solution - **Tool integration** — Undocumented API usage or configuration - **Trial-and-error** — Multiple attempts before success - **Repeatable workflows** — Multi-step task you'd do again - **User-facing automation** — Reports, checks, or processes users will request ## Workflow Phases ### PHASE 1: Evaluate (Self-Assessment) Before creating a skill, answer these questions: 1. "What did I just learn that wasn't obvious before starting?" 2. "Would future-me benefit from this being documented?" 3. "Was the solution non-obvious from documentation alone?" 4. "Is this a multi-step workflow I'd repeat?" **Continue only if YES to at least one question.** ### PHASE 2: Check Existing Skills Search for related skills to avoid duplication: ```bash # Check project skills ls .claude/skills/ 2>/dev/null # Search for keywords grep -r -i "KEYWORD" .claude/skills/ 2>/dev/null ``` **Outcomes:** - Nothing related → Create new skill (continue to Phase 3) - Same trigger & fix → Update existing skill (bump version) - Partial overlap → Update with new variant ### PHASE 3: Create Skill Create the skill file at `.claude/skills/[skill-name]/SKILL.md`: ```yaml --- name: descriptive-kebab-case-name description: | [What the skill does, then the situations it applies to — the key use first. Include an exact error string only when that string is the trigger.] - What the skill does - Trigger conditions (symptoms; an exact error message when that is the trigger) - When to use it (contexts, scenarios) metadata: author: [you] version: "1.0" argument-hint: "[expected arguments]" # Optional --- # Skill Name ## Problem [Clear problem description — what situation triggers this skill] ## Context / Trigger Conditions [When to use — exact error messages, symptoms, scenarios] [Be specific enough that you'd recognize it again] ## Solution [Step-by-step solution] [Include commands, code snippets, or workflows] ## Verification [How to verify it worked] [Expected output or state] ## Example [Concrete example of the skill in action] ## References [Documentation links, related files, or prior discussions] ``` ### PHASE 4: Quality Gates Before finalizing, verify: - [ ] Description has specific trigger conditions (not vague) - [ ] Solution was verified to work (tested) - [ ] Content is specific enough to be actionable - [ ] Content is general enough to be reusable - [ ] No sensitive information (credentials, personal data) - [ ] Skill name is descriptive and uses kebab-case ## Output After creating the skill, report: ``` ✓ Skill created: .claude/skills/[name]/SKILL.md Trigger: [when to use] Problem: [what it solves] ``` ## Example: Creating a Skill User discovers that a specific R package silently drops observations: ```markdown --- name: fixest-missing-covariate-handling description: | Handle silent observation dropping in fixest when covariates have missing values. Use when: estimates seem wrong, sample size unexpectedly small, or comparing results between packages. metadata: author: [you] version: "1.0" --- # fixest Missing Covariate Handling ## Problem The fixest package silently drops observations when covariates have NA values, which can produce unexpected results when comparing to other packages. ## Context / Trigger Conditions - Sample size in fixest is smaller than expected - Results differ from Stata or other R packages - Model has covariates with potential missing values ## Solution 1. Check for NA patterns before regression: ```r summary(complete.cases(data[, covariates])) ``` 2. Explicitly handle NA values or use `na.action` parameter 3. Document the expected sample size in comments ## Verification Compare `nobs(model)` with `nrow(data)` — difference indicates dropped obs. ## References - fixest documentation on missing values - [LEARN:r-code] entry in MEMORY.md ```
© Claude Code Academic Workflow · MIT · pedrohcgs/claude-code-my-workflow
Похожие скиллы
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Сначала — learn от других авторов.