# planetscale-customer-report-template

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1700 установок · ★ 136
- Автор: planetscale
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/planetscale/skills/tree/HEAD/planetscale-customer-report-template/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/planetscale-customer-report-template

## Что делает

Скилл нужен на финальном шаге оценки базы PlanetScale. Он берёт результаты инвентаризации и профильных проверок и сводит их в отчёт по фиксированной структуре: область работ, краткое резюме, текущее состояние, таблица рекомендаций и набор предлагаемых изменений, требующих подтверждения.

Внутри — шаблон с жёсткими правилами к тексту. Каждая рекомендация обязана ссылаться на конкретную находку: отпечаток запроса, метрику, число событий, временное окно. Неиспользуемые возможности описываются как пробел с измеренным эффектом, а не как «выключено, и это хорошо». Сбои инструментов — коды HTTP, ошибки MCP, таймауты — попадают в журнал запуска, а не в выводы: из неудачного вызова нельзя заключить, что функция не настроена, для этого нужен успешный вызов с пустым результатом.

Отчёт всегда пишется обычным markdown с заголовками, прозой и таблицами. Более богатая поверхность вроде Cursor canvas или HTML-превью допустима только вдобавок к markdown, не вместо него. Рекомендации размечаются префиксами `OBS-*`, `VIT-*`, `PG-*`, `WEB-*`, `APP-*` и `AGENT-*`, а разделы про безопасность и наблюдаемость различаются для Vitess и Postgres — это повод заранее понять, какой движок у вашей базы.

## Требования
- Работает с: PostgreSQL

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add planetscale/skills --skill planetscale-customer-report-template -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add planetscale/skills --skill planetscale-customer-report-template -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add planetscale/skills --skill planetscale-customer-report-template -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install planetscale/skills planetscale-customer-report-template
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add planetscale/skills --skill planetscale-customer-report-template -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/planetscale/skills --path planetscale-customer-report-template
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add planetscale/skills --skill planetscale-customer-report-template -a opencode
```

### Claude.ai

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

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

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

## Примеры запросов агенту
- Собери итоговый отчёт по базе PlanetScale: сначала инвентаризация, потом проверки, затем отчёт по шаблону
- Сделай assessment базы и подключённого репозитория, рекомендации разметь префиксами OBS- и PG-
- Оформи предложенные изменения отдельным разделом с планом теста и отката

## Похожие
- [neki](https://affpapa.org/nevibecode/skills/neki.md) — скилл · 1600 установок
- [creating-amazon-aurora-db-cluster-with-instances](https://affpapa.org/nevibecode/skills/creating-amazon-aurora-db-cluster-with-instances.md) — скилл · 6000 установок
- [optimize-database-performance](https://affpapa.org/nevibecode/commands/optimize-database-performance.md) — команда · 794 установки
- [database-administrator](https://affpapa.org/nevibecode/agents/database-administrator.md) — субагент · 452 установки
- [database-design](https://affpapa.org/nevibecode/skills/moizibnyousaf-database-design.md) — скилл · 604 установки
- [database-optimization](https://affpapa.org/nevibecode/agents/database-optimization.md) — субагент · 3924 установки

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

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