# pipefy-introspection

Скилл исследует GraphQL-схему Pipefy и выполняет прямые запросы через execute_graphql. Он выручает, когда стандартные операции API падают с ошибкой или для задачи нет готового инструмента.

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

## Что делает

Скилл служит вторым уровнем (Tier 2) в стратегии вызовов Pipefy API. Если готовый инструмент завершился ошибкой или его нет, агент исследует схему через интроспекцию и шлёт прямой GraphQL-запрос. В состав входят операции `introspect_type`, `introspect_query`, `introspect_mutation`, `search_schema`, `execute_graphql`, а также получение данных организаций через `get_organization` и `list_organizations`.

Параметр `max_depth` при интроспекции по умолчанию равен `1`. Значение `2` и выше раскрывает связанные типы прямо внутри ответа, избавляя от повторных вызовов. Если операция записи сообщила об ошибке, перед повторной попыткой через сырой GraphQL нужно обязательно перечитать целевой объект. Повторный вызов вслепую легко создаст дубликат данных в пайплайне.

Имена типов чувствительны к регистру. Запрос вернёт `null`, если передать имя типа не в PascalCase.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pipefy/ai-toolkit --skill pipefy-introspection -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pipefy/ai-toolkit --skill pipefy-introspection -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pipefy/ai-toolkit --skill pipefy-introspection -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pipefy/ai-toolkit pipefy-introspection
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pipefy/ai-toolkit --skill pipefy-introspection -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/pipefy/ai-toolkit --path plugins/pipefy/skills/pipefy-introspection
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add pipefy/ai-toolkit --skill pipefy-introspection -a opencode
```

### Claude.ai

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

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

## Когда брать
- изучить структуру аргументов мутации Pipefy GraphQL
- выполнить произвольный GraphQL-запрос к API Pipefy
- узнать доступные значения перечисления `FieldTypeId`
- найти карточку по названию через запрос карточек пайпа

## Примеры запросов агенту
- Проверь через интроспекцию, какие поля принимает мутация `createCard`
- Выполни сырой GraphQL-запрос, чтобы узнать организацию для пайпа с id `<pipe-id>`
- Найди в схеме Pipefy типы с ключевым словом `automation`

## Похожие
- [mcp-builder](https://affpapa.org/nevibecode/skills/mcp-builder.md) — скилл · 130949 установок
- [claude-api](https://affpapa.org/nevibecode/skills/claude-api.md) — скилл · 74198 установок
- [lark-im](https://affpapa.org/nevibecode/skills/lark-im.md) — скилл · 472900 установок
- [lark-event](https://affpapa.org/nevibecode/skills/lark-event.md) — скилл · 466800 установок
- [caveman-discover](https://affpapa.org/nevibecode/skills/caveman-discover.md) — скилл · 104400 установок
- [migration](https://affpapa.org/nevibecode/skills/migration.md) — скилл · 103900 установок

Из того же набора: [pipefy/ai-toolkit](https://affpapa.org/nevibecode/by/pipefy/ai-toolkit.md) — 14 карточек

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

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