# netsuite-ai-connector-instructions

Скилл задаёт ИИ порядок выбора инструментов NetSuite, формат вывода и правила безопасности SuiteQL. Нужен, если агент ходит в живой аккаунт через MCP-коннектор.

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

## Что делает

Скилл включается в сессию с NetSuite AI Service Connector и дальше применяется к каждому ответу. Он описывает обязательную очерёдность инструментов: сначала стандартные отчёты, потом сохранённые поиски, затем работа с записями, и только в конце — свой SuiteQL. Агент не должен молча уходить в кастомный запрос: если ни отчёт, ни поиск не подошли, он спрашивает у вас разрешение.

Внутри — таблицы форматирования чисел, шаблоны ссылок на транзакции и сущности, порог, после которого ответ стоит собирать в React-артефакт, и справочник по типам записей NetSuite. Отдельный блок про бухгалтерию: нормальные сальдо счетов, двойная запись, закрытые периоды. Есть и жёсткие запреты — например, `ROWNUM <= 1000` в любом запросе SuiteQL и запрет на автоматический повтор упавшего `ns_createRecord`: сначала проверьте запись в самой NetSuite.

Скилл рассчитан на работу через MCP-коннектор к живому аккаунту, поэтому без подключённого коннектора он ничего не даст. Часть про мультивалютность и мультидочерние компании опирается на поля вроде `foreignamount` и `exchangerate`, так что для одновалютного аккаунта эти правила просто не сработают.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-ai-connector-instructions -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-ai-connector-instructions -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-ai-connector-instructions -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install oracle/netsuite-suitecloud-sdk netsuite-ai-connector-instructions
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-ai-connector-instructions -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/oracle/netsuite-suitecloud-sdk --path packages/agent-skills/netsuite-ai-connector-instructions
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add oracle/netsuite-suitecloud-sdk --skill netsuite-ai-connector-instructions -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/oracle/netsuite-suitecloud-sdk/tree/HEAD/packages/agent-skills/netsuite-ai-connector-instructions/SKILL.md

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

## Примеры запросов агенту
- Покажи выручку по дочерним компаниям за квартал
- Найди все неоплаченные счета клиента и дай ссылки на них
- Создай счёт на основе этого заказа

## Похожие
- [connector-marketplace-strategy](https://affpapa.org/nevibecode/skills/connector-marketplace-strategy.md) — скилл · 8100 установок
- [etl-connector-strategy](https://affpapa.org/nevibecode/skills/etl-connector-strategy.md) — скилл · 8000 установок
- [journal-entry](https://affpapa.org/nevibecode/skills/journal-entry.md) — скилл · 2800 установок
- [d365-solution-blueprint](https://affpapa.org/nevibecode/skills/d365-solution-blueprint.md) — скилл · 13 установок
- [connector-googledrive](https://affpapa.org/nevibecode/skills/connector-googledrive.md) — скилл · 9100 установок
- [connector-weatherapi](https://affpapa.org/nevibecode/skills/connector-weatherapi.md) — скилл · 7300 установок

Из того же набора: [oracle/netsuite-suitecloud-sdk](https://affpapa.org/nevibecode/by/oracle/netsuite-suitecloud-sdk.md) — 7 карточек

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