# encore-service

Помогает настроить сервисы и каталоги в проектах на Encore.ts. Пригодится при создании микросервисов и организации вызовов через ~encore/clients.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 819 установок · ★ 30
- Автор: encoredev
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/encoredev/skills/tree/HEAD/encore/service/SKILL.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/skills/encore-service

## Что делает

Скилл описывает правила создания бэкенд-сервисов на Encore.ts. Он задаёт обязательную структуру: каждый сервис должен содержать файл `encore.service.ts` с вызовом `new Service()`. Ассистент учится раскладывать эндпоинты в `api.ts`, подключать миграции и базы данных в `db.ts`, а также объединять связанные микросервисы в системные папки вроде `commerce` или `identity`.

Вызывать соседний сервис через прямой относительный импорт файлов нельзя: архитектура Encore требует обращения строго через виртуальный пакет `~encore/clients`. Если границы сервисов ещё не определены, исходные инструкции рекомендуют сначала воспользоваться скиллом `encore-architecture`. Вкладывать один сервис внутрь другого тоже запрещено.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add encoredev/skills --skill encore-service -a claude-code
```
```bash
npx skills add encoredev/skills --skill service -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add encoredev/skills --skill service -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add encoredev/skills --skill service -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install encoredev/skills service
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add encoredev/skills --skill service -a gemini-cli
```

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add encoredev/skills --skill service -a opencode
```

### Claude.ai

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

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

## Когда брать
- Создать новый микросервис на Encore.ts с обязательным файлом `encore.service.ts`
- Сгруппировать сервисы крупного проекта по системным папкам
- Настроить типизированные вызовы между микросервисами через `~encore/clients`
- Разделить эндпоинты и доступ к базе данных по структуре `api.ts` и `db.ts`

## Примеры запросов агенту
- Создай новый сервис заказов `order` с файлом `encore.service.ts` и базой данных
- Сгруппируй сервисы оплаты и корзины внутри папки `commerce`
- Напиши вызов сервиса пользователей из сервиса заказов через `~encore/clients`

## Похожие
- [backend-architect](https://affpapa.org/nevibecode/skills/backend-architect.md) — скилл · 501 установка
- [microservices-patterns](https://affpapa.org/nevibecode/skills/microservices-patterns.md) — скилл · 13176 установок
- [vtex-io-service-runtime](https://affpapa.org/nevibecode/skills/vtex-io-service-runtime.md) — скилл · 1100 установок
- [voltagent-core-dev](https://affpapa.org/nevibecode/plugins/voltagent-core-dev.md) — плагин · ★ 26093
- [vtex-io-service-apps](https://affpapa.org/nevibecode/skills/vtex-io-service-apps.md) — скилл · 1200 установок
- [elysiajs](https://affpapa.org/nevibecode/skills/elysiajs.md) — скилл · 14000 установок

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

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

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