К основному содержанию
скилл CX Codex

self-improving-agent · jdrhyne — скилл для Claude Code

Скилл self-improving-agent ведёт локальный журнал в .learnings/: ошибки, правки пользователя и запросы на недостающие возможности. Агент перечитывает его перед крупными задачами.

MIT ★ 239 обновлён 2026-08-30

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add jdrhyne/agent-skills --skill self-improving-agent -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/self-improving-agent/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/self-improving-agent/

По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.

self-improving-agent Alireza Rezvani Скилл self-improving-agent для Claude Code, который разбирает авто-память агента и превращает проверенные находки в правила проекта. Обновляет MEMORY.md, чистит устаревшие записи и переносит повторяющиеся исправления в отдельные скиллы. CX Codex +1 1 078установок self-improving-agent zhaono1 Скилл self-improving-agent превращает ошибки, правки пользователя и найденные обходные пути в проверяемые правила для ИИ-агента. Помогает фиксировать опыт без слепой перезаписи инструкций. CX Codex +1 35 900установок self-improving-agent pskoett Скилл self-improving-agent ведёт markdown-журнал ошибок, правок и находок агента, чтобы удачные решения не терялись между сессиями. CX Codex +1 408установок self-improving-agent borghei Скилл self-improving-agent для Claude Code, Codex и Cursor организует аудит долговременной памяти ассистента. Превращает повторяющийся опыт сессий в проверенные постоянные правила. CX Codex +1 244установок self-improving-agent Grail-Computer Скилл self-improving-agent учит агента анализировать свои ошибки, сохранять правила проекта в AGENTS.md и превращать повторяющиеся цепочки действий в новые готовые скиллы. CX Codex +1 520установок self-improvement pskoett Скилл self-improvement копит твои исправления, сбои и запросы на новые возможности в markdown-файлах, чтобы агент потом вынес из них правила для проекта. CX Codex +1 2 100установок memory-curate basicmachines-co Скилл memory-curate связывает разрозненные заметки в граф знаний Basic Memory. Скилл находит заметки-сироты, правит теги и собирает обзорные хаб-документы. CX Codex +1 1 500установок ce-compound-refresh EveryInc Скилл ce-compound-refresh сохраняет обратную совместимость для старых скриптов обновления базы знаний. Перенаправляет вызовы на скилл ce-compound. CX Codex +1 3 500установок planning-with-files OthmanAdi Скилл planning-with-files держит план многошаговой задачи в трёх markdown-файлах и возвращает к ним агента каждый ход — контекст не разваливается на длинной сессии. CX Codex +1 ★ 28 179звёзд репо replay-learnings Rohit Ghumare Скилл replay-learnings ищет в файлах проекта прошлые исправления и похожие сессии, а затем показывает релевантные уроки. Запустите его перед новой задачей, чтобы учесть прежние ошибки. CX Codex +1 ★ 2 966звёзд репо Docmancer docmancer MCP-сервер Docmancer для Claude Code, Codex и других агентов: индексирует память, правила и историю из локальных сессий и собирает их в единое Markdown-хранилище. CX Codex +1 ★ 133звёзд репо

Из того же набора27

Весь набор →
skill-sync Скилл skill-sync управляет навыками из общего GitHub-репозитория: показывает список, устанавливает обновления и отправляет локальные изменения через PR. CX Codex +1 ★ 239звёзд репо clawdbot-release-check Скилл clawdbot-release-check следит за релизами OpenClaw на GitHub и пишет о каждом новой версии один раз. Умеет работать по cron и отправлять уведомление в Telegram. CX Codex +1 ★ 239звёзд репо Zendesk Скилл обращается к Zendesk API: ищет и меняет тикеты, проверяет пользователей и готовит выгрузки очереди. Нужны учётные данные в переменных окружения. CX Codex +1 ★ 239звёзд репо knowledge-graph Скилл knowledge-graph сохраняет устойчивые факты о людях, компаниях и проектах в графе знаний. Он пригодится, когда нужно переносить контекст между сессиями и находить его без просмотра длинных переписок. CX Codex +1 ★ 239звёзд репо planner Скилл planner разбивает сложные задачи на спринты и атомарные шаги с проверками, готовя детальный Markdown-план для параллельного выполнения субагентами. CX Codex +1 ★ 239звёзд репо parallel-task Разбирает markdown-план по спринтам и задачам, затем раздаёт незаблокированные задачи параллельным субагентам. Запускается командой /parallel-task. CX Codex +1 ★ 239звёзд репо elegant-reports Скилл elegant-reports собирает PDF из markdown в сдержанной скандинавской вёрстке: брифинги для руководства, аналитические разборы, презентационные страницы. CX Codex +1 ★ 239звёзд репо gsc Скилл gsc подключает Claude Code к Google Search Console в режиме чтения для проверки аналитики поиска, индексации страниц и карт сайта. CX Codex +1 ★ 239звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой