# self-improving-agent

Скилл ведёт markdown-журнал ошибок, правок и находок агента, чтобы удачные решения не терялись между сессиями.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 353 установки · ★ 779
- Автор: pskoett
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/pskoett/self-improving-agent/tree/HEAD/self-improving-agent/SKILL.md
- Обновлён: 2026-10-22
- HTML: https://affpapa.org/nevibecode/skills/pskoett-self-improving-agent

## Что делает

Скилл складывает всё, что стоит запомнить, в три файла внутри `.learnings/`: `LEARNINGS.md` для правок, пробелов в знаниях и удачных приёмов, `ERRORS.md` для упавших команд и ошибок интеграций, `FEATURE_REQUESTS.md` для запрошенных возможностей. При первом запуске каталог и файлы создаются сами, существующие не перезаписываются. Дальше агент перед крупной задачей заглядывает в накопленное и переиспользует то, что подходит.

Записи с общим смыслом переезжают в файлы воркспейса: поведенческие шаблоны — в `SOUL.md`, улучшения процесса — в `AGENTS.md`, подводные камни инструментов — в `TOOLS.md`. Повторяющиеся случаи помечаются `Pattern-Key`, чтобы не плодить дубли, а новая запись считалась только при новом вхождении. Перепроверять сохранённое скилл советует не по возрасту записи, а по тому, что могло измениться: источник, решение, зависимость или задача.

Секреты, токены и переменные окружения в журнал не попадают — только короткие пересказы или вырезанные фрагменты. Автоматические напоминания и разбор ошибок в конце сессии включаются отдельно, через хук, и работают только там, где `.learnings/` уже существует. Эта версия собрана под OpenClaw; для остальных агентов автор отсылает к исходной мультиагентной версии в своём репозитории.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pskoett/self-improving-agent --skill self-improving-agent -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/self-improving-agent/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/self-improving-agent/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pskoett/self-improving-agent --skill self-improving-agent -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/self-improving-agent/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pskoett/self-improving-agent --skill self-improving-agent -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/self-improving-agent/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pskoett/self-improving-agent self-improving-agent
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/self-improving-agent/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pskoett/self-improving-agent --skill self-improving-agent -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/pskoett/self-improving-agent --path self-improving-agent
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/self-improving-agent/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add pskoett/self-improving-agent --skill self-improving-agent -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/pskoett/self-improving-agent/tree/HEAD/self-improving-agent/SKILL.md

## Когда брать
- записать упавшую команду, чтобы не наступить на неё снова
- сохранить правку пользователя как правило работы
- отметить нехватку возможности и вернуться к ней позже
- поднять удачный приём из прошлой сессии в текущую задачу
- перенести повторяющийся подводный камень инструмента в заметки воркспейса

## Примеры запросов агенту
- залогируй эту ошибку в `.learnings/ERRORS.md`
- пользователь поправил моё предположение — запиши это как correction
- проверь `.learnings/LEARNINGS.md` перед тем, как браться за рефакторинг

## Похожие
- [self-learning](https://affpapa.org/nevibecode/skills/kulaxyz-self-learning.md) — скилл · 850 установок
- [blueprint](https://affpapa.org/nevibecode/skills/blueprint.md) — скилл · 4600 установок
- [planning-with-files](https://affpapa.org/nevibecode/skills/zhaono1-planning-with-files.md) — скилл · 1200 установок
- [desk-open](https://affpapa.org/nevibecode/skills/desk-open.md) — скилл · 23 установки
- [self-hosted-funnel-launch](https://affpapa.org/nevibecode/skills/self-hosted-funnel-launch.md) — скилл · 103000 установок
- [convex-self-heal](https://affpapa.org/nevibecode/skills/convex-self-heal.md) — скилл · 35800 установок

## Другие версии с тем же именем
- [self-improving-agent · alirezarezvani](https://affpapa.org/nevibecode/skills/self-improving-agent.md) — 1078 установок
- [self-improving-agent · zhaono1](https://affpapa.org/nevibecode/skills/zhaono1-self-improving-agent.md) — 35100 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md