self-improving-agent · jdrhyne — скилл для Claude Code
Скилл self-improving-agent ведёт локальный журнал в .learnings/: ошибки, правки пользователя и запросы на недостающие возможности. Агент перечитывает его перед крупными задачами.
MIT ★ 239 обновлён 2026-08-30
npx skills add jdrhyne/agent-skills --skill self-improving-agent -a claude-codeЧто делает self-improving-agent
Скилл держит небольшой журнал рядом с проектом. Записи идут в .learnings/LEARNINGS.md, .learnings/ERRORS.md и .learnings/FEATURE_REQUESTS.md, каталог создаётся при первом обращении. Каждая запись — блок markdown с идентификатором вида LRN-YYYYMMDD-XXX, приоритетом, статусом и областью: frontend, backend, infra, tests, docs или config. Дальше Summary, Details и Suggested Action: что случилось и что теперь считается правильным.
Повторяющиеся случаи связываются через поле See Also, статус меняется, когда проблема закрыта или стала правилом. Перед большой задачей в знакомой области скилл советует перечитать .learnings/. Решение, которое выдержало проверку и годится не только для этого проекта, выносят в отдельный скилл, а в записи помечают, где правило теперь живёт. Не каждый сбой достоин строки: скилл просит не засорять журнал мелочью.
Права узкие — только запись файлов внутри .learnings. Токены, приватные ключи и персональные данные логировать нельзя, пользовательские файлы правил скилл трогает лишь по прямой просьбе, а статус resolved ставит после проверки фикса. Записи создаются в рабочем каталоге проекта, поэтому .learnings/ придётся либо коммитить, либо закрыть в .gitignore.
Какие задачи решает
- Записать разбор упавшей команды, чтобы не искать причину заново
- Сохранить поправку пользователя к конвенциям проекта
- Отследить запрос на возможность, которой у агента нет
- Связать повторяющиеся сбои в одну серию записей
- Перечитать накопленные уроки перед работой в знакомой области
Примеры запросов агенту
- Сборка упала с той же ошибкой, что и вчера. Занеси разбор в
.learnings/ERRORS.md. - Ты ошибся: миграции у нас запускаются через
make migrate, а неalembic upgrade. Запиши это как обучение. - Перед рефакторингом оплаты перечитай
.learnings/за прошлый месяц.
Как установить self-improving-agent
1Через Skills CLI (Vercel)
npx skills add jdrhyne/agent-skills --skill self-improving-agent -a claude-code2Вручную: положить файлы
~/.claude/skills/self-improving-agent/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/self-improving-agent/
1Через Skills CLI (Vercel)
npx skills add jdrhyne/agent-skills --skill self-improving-agent -a codex2Вручную: положить файлы
.agents/skills/self-improving-agent/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jdrhyne/agent-skills --skill self-improving-agent -a cursor2Вручную: положить файлы
.cursor/skills/self-improving-agent/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jdrhyne/agent-skills clawdbot/self-improving-agent/SKILL.md2Вручную: положить файлы
.github/skills/self-improving-agent/SKILL.md1Через Skills CLI (Vercel)
npx skills add jdrhyne/agent-skills --skill self-improving-agent -a gemini-cli2Командой платформы
gemini skills install https://github.com/jdrhyne/agent-skills --path clawdbot/self-improving-agentВручную: положить файлы
.devin/skills/self-improving-agent/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о self-improving-agent
Как установить self-improving-agent в Claude Code?
Выполните npx skills add jdrhyne/agent-skills --skill self-improving-agent -a claude-code. Файл скилла окажется по пути ~/.claude/skills/self-improving-agent/SKILL.md.
Что делает self-improving-agent?
Складывает в .learnings/ заметки об ошибках, правках и недостающих возможностях, связывает их между собой и напоминает просмотреть журнал перед крупной задачей.
Чем запись Learning отличается от Error?
Learning фиксирует поправку или конвенцию проекта, Error — воспроизводимый сбой с текстом ошибки и контекстом запуска. Шаблоны разные, префиксы тоже: LRN- и ERR-.
Исходный текст
SKILL.md · MIT
---
name: self-improving-agent
description: "Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Claude ('No, that's wrong...', 'Actually...'), (3) User requests a capability that doesn't exist, (4) An external API or tool fails, (5) Claude realizes its knowledge is outdated or incorrect, (6) A better approach is discovered for a recurring task. Also review learnings before major tasks."
permissions:
- file_write: "Appends learning, error, and feature-request notes inside the local .learnings directory."
---
# Self-Improvement Skill
Capture non-obvious lessons, failures, and feature requests in a small local knowledge base so the same mistakes are less likely to repeat.
## When to Use
- A command, tool, or integration fails in a way worth remembering
- The user corrects an assumption or teaches a project-specific convention
- You discover a better repeatable workflow
- The user asks for a missing capability that should be tracked
- You are starting work in an area with known prior learnings
## Storage
Keep entries in a local `.learnings/` directory:
- `.learnings/LEARNINGS.md`
- `.learnings/ERRORS.md`
- `.learnings/FEATURE_REQUESTS.md`
Create the directory on first use if it does not exist.
## Record Types
### Learning
Use for corrections, conventions, and better practices.
```markdown
## [LRN-YYYYMMDD-XXX] category
**Logged**: ISO-8601 timestamp
**Priority**: low | medium | high | critical
**Status**: pending
**Area**: frontend | backend | infra | tests | docs | config
### Summary
One-line learning
### Details
What happened and what is now known to be correct
### Suggested Action
Specific follow-up or rule
### Metadata
- Source: conversation | error | user_feedback
- Related Files: path/to/file.ext
- Tags: tag1, tag2
- See Also: LRN-20250110-001
```
### Error
Use for reproducible failures or flaky workflows.
```markdown
## [ERR-YYYYMMDD-XXX] tool_or_workflow
**Logged**: ISO-8601 timestamp
**Priority**: high
**Status**: pending
**Area**: frontend | backend | infra | tests | docs | config
### Summary
Short failure description
### Error
Exact error text or symptoms
### Context
- Operation attempted
- Inputs or environment details
### Suggested Fix
Likely next step
```
### Feature Request
Use for missing capabilities the user wants tracked.
```markdown
## [FEAT-YYYYMMDD-XXX] capability_name
**Logged**: ISO-8601 timestamp
**Priority**: medium
**Status**: pending
**Area**: frontend | backend | infra | tests | docs | config
### Requested Capability
What the user wanted
### User Context
Why it matters
### Suggested Implementation
Likely extension point or implementation direction
```
## Workflow
1. Log the learning as soon as the context is clear.
2. Link related entries with `See Also` when patterns repeat.
3. Update status when the issue is resolved, rejected, or turned into a reusable rule.
4. Review `.learnings/` before major work in a familiar problem area.
## Promotion Rules
If a learning becomes broadly reusable:
- distill it into a concise rule
- move it into the repo's shared guidance only if the user explicitly wants that promotion
- update the learning entry to note where the rule now lives
Recurring patterns are good candidates for extraction into a dedicated skill when the solution is verified, portable, and no longer project-specific.
## Safety Boundaries
- Do not modify user-owned policy or guidance files unless the user explicitly asked for that promotion.
- Do not log secrets, access tokens, private keys, or sensitive personal data in `.learnings/`.
- Do not treat every failure as worth logging; prefer durable lessons over noise.
- Do not mark an entry resolved unless the fix was actually verified.
© jdrhyne · MIT · jdrhyne/agent-skills
Похожие скиллы
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Сначала — self-improving-agent от других авторов.