Apollo GraphQL Agent Skills — плагин

Скиллы Apollo для ИИ-агентов: Client, Server, iOS, Kotlin, MCP Server, Rover, схемы и операции GraphQL. Ставятся через npx skills.

  • 130 ★ репозитория
  • Последний коммит
  • MIT
ПлагинОфициальный

Минимальный доступ

Почему такой уровень

  • Скиллы дают инструкции для агента и справочные файлы, сами ничего не запускают.
Все причины и проверки

apollographql/skills

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add plugins/apollo-graphql-agent-skills

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Минимальный доступИнструмент ничего не запускает и не ходит в сеть.

  • Скиллы дают инструкции для агента и справочные файлы, сами ничего не запускают.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Набор от самой Apollo учит кодовых агентов работать с ее инструментами по принятым в компании правилам. В нем скиллы для Apollo Client 4.x под React (запросы, мутации, кеш, локальное состояние), Apollo Server 4.x (схемы, резолверы, авторизация, плагины), Apollo iOS на Swift и Apollo Kotlin для Android, а также скиллы по Apollo MCP Server, Rover, GraphOS Factory, проектированию схем и операций GraphQL и идиоматичному Rust. Скиллы подключают тремя путями: интерактивной командой `npx skills add apollographql/skills`, как плагин Claude Code с командами вида `/apollo-skills:apollo-client` или через `gh skill install`. У каждого скилла своя папка с `SKILL.md` и справочными файлами, например по кешированию, фрагментам и обработке ошибок.

Для кого. Разработчикам, которые строят на Apollo GraphQL и хотят, чтобы Claude Code, Cursor или Codex писали клиент, сервер и схемы по рекомендациям вендора.

Подходит, если

  • Агент подключает Apollo Client 4 к React-приложению и настраивает кеш и фрагменты.
  • Проектируется схема GraphQL: типы, названия, пагинация, обработка ошибок.
  • Нужно написать резолверы и плагины для Apollo Server 4.
  • Мобильная команда разбирает Apollo iOS или Apollo Kotlin и хочет единый стиль кода.

Не подходит, если

  • Проект не использует Apollo: скиллы привязаны к его инструментам и версиям.
  • Нужна работа с Apollo Connectors: этот скилл устарел, вместо него `graphos-factory`.
  • Нужен готовый MCP-сервер: скилл `apollo-mcp-server` описывает работу с ним, сам сервер ставят отдельно.

Пример запроса к агенту

Спроектируй схему GraphQL для каталога товаров с пагинацией и ошибками по правилам Apollo.

Ограничения

Скиллы привязаны к конкретным версиям, например Apollo Client 4.x и Apollo Server 4.x, а для других мажорных версий советы могут не подойти. Скилл `apollo-connectors` помечен устаревшим, его заменяет `graphos-factory`. Установка через npx открывает интерактивный мастер, где выбирают скиллы, агентов (Claude Code, Codex, Cursor, Gemini CLI, Goose, OpenCode), область и способ: ссылка или копия. Релизы выходят с тегами semver, а закрепить версию можно флагом `--pin` у `gh skill install`. Часть скиллов рассчитана на Rust, Swift или Kotlin, поэтому нужные инструменты разработки ставят отдельно.

Как отключить. Для Claude Code выполните `/plugin uninstall apollo-skills@apollo-marketplace`. После установки через `npx skills` удалите папки скиллов из каталога агента или проекта.

Частые вопросы

Как установить скиллы Apollo для Claude Code?

Выполните `/plugin marketplace add apollographql/skills`, затем `/plugin install apollo-skills@apollo-marketplace`. Скиллы появятся как команды вида `/apollo-skills:apollo-client`. Другой путь: `npx skills add apollographql/skills`.

Какие агенты поддерживает установка через npx skills?

Мастер показывает Claude Code, Codex, Cursor, Gemini CLI, Goose и OpenCode. Через `gh skill install --agent` поддерживается еще больше хостов, включая GitHub Copilot.

Как закрепить версию скиллов?

Командой `gh skill install apollographql/skills --pin v1.0.0 --agent claude-code`. Закрепленная версия пропускается при обновлении. Без закрепления плагин обновляет `claude plugin update`.

Что делать со скиллом apollo-connectors?

Он помечен устаревшим. Вместо него берут `graphos-factory`, который собирает и дорабатывает подграф Apollo Connectors поверх REST API.

Нужен ли отдельно Apollo MCP Server?

Скилл `apollo-mcp-server` объясняет, как соединить ИИ-агентов с API GraphQL через этот сервер, но сам сервер ставится отдельно по документации Apollo.

Обсуждение

Вопросов и отзывов пока нет.

Плагины

OpenClaw Agent Skills

openclaw-agent-skills

Официальный

Общие скиллы для кодовых агентов, которые работают над проектами OpenClaw: ревью и другие рабочие процессы. Узкая тема для тех, кто пишет код OpenClaw

СкиллРасширенный доступ1,1 тыс.Звезды репозитория

skills-npm подключает скиллы агентов из зависимостей проекта в node_modules и из поля skills в package.json

CLIРасширенный доступ582Звезды репозитория

Softaworks Agent Toolkit

Softaworks Agent Skills

Маркетплейс скиллов, субагентов и команд для кодовых агентов: разработка, документация, планирование и рабочая коммуникация

ПлагинРасширенный доступ2,7 тыс.Звезды репозитория

Builder Skills

Skills for agents

Набор небольших скиллов от Builder.io для рабочих привычек агента: визуальные планы и разборы диффов, сверка с документацией, кросс-агентное ревью и аккуратные

СкиллРасширенный доступ4,7 тыс.Звезды репозитория

Свыше 1100 готовых скиллов для Claude Code, Codex, Gemini CLI и Cursor и MCP-сервер, который подбирает скилл под задачу

СкиллРасширенный доступ200Звезды репозитория

Проверяемый реестр скиллов с CLI для установки в два десятка агентов и MCP-сервером для поиска скиллов на лету

СкиллРасширенный доступ7,2 тыс.Звезды репозитория

Коротко о README

Репозиторий описывает набор скиллов в формате Agent Skills, три способа установки, таблицу команд плагина и правила выпуска версий. Релизы тегируются автоматически при каждом изменении содержимого в main, а закрепление версии доступно через GitHub CLI.

Бейдж для README

Исходный SKILL.md

---
name: graphql-schema
description: >
  Guide for designing and changing GraphQL schemas following industry best practices. Use this skill
  whenever you create or edit GraphQL SDL, such as a `schema.graphql` file or `typeDefs`, including when:
  (1) designing a new GraphQL schema or API,
  (2) adding or changing types, fields, arguments, mutations, or descriptions in an existing schema,
  (3) reviewing existing schema for improvements,
  (4) deciding on type structures or nullability,
  (5) implementing pagination or error patterns,
  (6) ensuring security in schema design.
license: MIT
compatibility: Any GraphQL implementation (Apollo Server, graphql-js, Yoga, etc.)
metadata:
  author: apollographql
  version: "1.0.2"
allowed-tools: Bash(npm:*) Bash(npx:*) Read Write Edit Glob Grep
---

# GraphQL Schema Design Guide

This guide covers best practices for designing GraphQL schemas that are intuitive, performant, and maintainable. Schema design is primarily a server-side concern that directly impacts API usability.

## Schema Design Principles

### 1. Design for Client Needs

- Think about what queries clients will write
- Organize types around use cases, not database tables
- Expose capabilities, not implementation details

### 2. Be Explicit

- Use clear, descriptive names
- Make nullability intentional
- Document with descriptions

### 3. Design for Evolution

- Plan for backwards compatibility
- Use deprecation before removal
- Avoid breaking changes
- Give every new argument or input field a default value, or make it nullable. Existing clients don't send it, so a required field without a default makes their requests fail validation.

## Quick Reference

Сообщить о проблеме