# laravel-database-optimization

Набор правил по запросам Eloquent, индексам и кэшу Redis для Laravel 13. Пригодится, когда проект тормозит на выборках или миграции ломают прод.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1000 установок · ★ 95
- Автор: agent-skills
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/AsyrafHussin/agent-skills/tree/HEAD/skills/laravel-database-optimization/SKILL.md
- Обновлён: 2026-08-27
- HTML: https://affpapa.org/nevibecode/skills/laravel-database-optimization

## Что делает

Скилл содержит 33 правила в 9 категориях: производительность запросов и N+1, стратегии индексирования, оптимизация Eloquent, кэширование через Redis, пагинация и большие выборки, транзакции и блокировки, миграции, отладка запросов, соглашения об именовании. Каждое правило лежит отдельным файлом в `rules/` с примерами «плохо» и «хорошо».

Агент подхватывает скилл, когда вы пишете запросы через query builder, чините N+1, добавляете индексы в миграции или разбираете медленный запрос через EXPLAIN. Внутри есть готовые образцы: `Model::preventLazyLoading()`, `Cache::remember` с TTL, `cursorPaginate`, `withCount`, `chunkById`, короткие транзакции через `DB::transaction`.

Скилл рассчитан на Laravel 13.x и PHP 8.3+. На более старых версиях часть примеров не соберётся, потому что синтаксис и API там другие. Установка идёт через `npx skills add` — под конкретную платформу флаг `-a` меняется.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add AsyrafHussin/agent-skills --skill laravel-database-optimization -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add AsyrafHussin/agent-skills --skill laravel-database-optimization -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add AsyrafHussin/agent-skills --skill laravel-database-optimization -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install AsyrafHussin/agent-skills laravel-database-optimization
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add AsyrafHussin/agent-skills --skill laravel-database-optimization -a gemini-cli
```

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add AsyrafHussin/agent-skills --skill laravel-database-optimization -a opencode
```

### Claude.ai

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

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

## Когда брать
- убрать N+1 в списке с отношениями
- добавить составной индекс под частый фильтр
- закэшировать тяжёлую выборку в Redis
- переписать пагинацию на cursor для большой таблицы
- провести миграцию без блокировки таблицы

## Примеры запросов агенту
- Убери N+1 в выборке постов с комментариями, покажи вариант с eager loading
- Добавь составной индекс в миграцию для фильтра по `status` и `created_at`
- Закэшируй топ-10 постов по комментариям через `Cache::remember` на час

## Похожие
- [xlsx](https://affpapa.org/nevibecode/skills/xlsx.md) — скилл · 187223 установки
- [google-agents-cli-observability](https://affpapa.org/nevibecode/skills/google-agents-cli-observability.md) — скилл · 511300 установок
- [caveman-evidence-review](https://affpapa.org/nevibecode/skills/caveman-evidence-review.md) — скилл · 104500 установок
- [migration](https://affpapa.org/nevibecode/skills/migration.md) — скилл · 103900 установок
- [performance-optimization](https://affpapa.org/nevibecode/skills/performance-optimization.md) — скилл · 65200 установок
- [supabase](https://affpapa.org/nevibecode/skills/supabase.md) — скилл · 8 установок

Из того же набора: [asyrafhussin/agent-skills](https://affpapa.org/nevibecode/by/asyrafhussin/agent-skills.md) — 22 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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