Навыки агентов Pixelesq

Управляйте сайтами на Pixelesq с помощью любого AI-агента. Создавайте и редактируйте страницы по разделам, добавляйте материалы в коллекции, настраивайте SEO и структурированные данные, просматривайте данные Search Console и аналитику сайта, управляйте редиректами и изображениями, меняйте оформление темы и публикуйте изменения по запросу пользователя.

Этот репозиторий объединяет три компонента:

Семь навыков в формате Agent Skills, которые загружаются в Claude Code, Cursor, Codex, Copilot, Gemini CLI, Goose и другие совместимые агенты.
Четыре специализированных агента для Claude Code и любых платформ, которые поддерживают файлы из agents/*.md.
Коннектор Pixelesq MCP, описанный в .mcp.json: https://mcp.pixelesq.app/mcp, 68 инструментов и вход через OAuth с аккаунтом Pixelesq.

Установка

Claude Code (плагин)

/plugin marketplace add pixelesq/pixelesq-skills
/plugin install pixelesq@pixelesq

Затем запустите /mcp и войдите в Pixelesq. Навыки загружаются по мере необходимости. Агенты доступны под именами @pixelesq:site-manager, @pixelesq:seo-specialist, @pixelesq:content-strategist и @pixelesq:design-consultant, а коннектор регистрируется из .mcp.json.

Claude Code (только коннектор)

claude mcp add --transport http pixelesq https://mcp.pixelesq.app/mcp

Claude.ai и Claude Desktop

Откройте Settings → Connectors → Add custom connector, вставьте https://mcp.pixelesq.app/mcp и войдите в систему.

ChatGPT

Откройте Settings → Apps & Connectors → Advanced, включите developer mode, нажмите Create и вставьте https://mcp.pixelesq.app/mcp.

Cursor

Установите плагин из Cursor Marketplace или добавьте сервер в mcp.json:

{ "mcpServers": { "pixelesq": { "url": "https://mcp.pixelesq.app/mcp" } } }

VS Code

{ "servers": { "pixelesq": { "type": "http", "url": "https://mcp.pixelesq.app/mcp" } } }

Другие платформы

Клонируйте репозиторий, укажите для агента каталог навыков skills/ и настройте URL MCP-сервера https://mcp.pixelesq.app/mcp. Клиенты могут регистрироваться динамически или передавать документ метаданных с ID клиента — поддерживаются оба способа.

Вход и разрешения

Коннектор использует OAuth 2.1 с PKCE. Войдите через Google или с помощью адреса электронной почты Pixelesq и кода, который будет отправлен вам. Для работы необходим аккаунт Pixelesq хотя бы с одним проектом. Зарегистрируйтесь на https://app.pixelesq.ai.

Разрешения предоставляются при входе и фиксируются в токене: projects:read, content:read, content:write, publish, analytics:read. Если инструменту не предоставлено нужное разрешение, он откажет в выполнении и предложит клиенту подключиться заново.

Как обеспечивается безопасность изменений

Каждое сохранение изменяет черновик. Опубликованный сайт обновляется только при вызове publish_page, publish_partial, publish_entry, update_theme с параметром publish: true и update_form_schema (у формы нет черновика). Навыки указывают агенту сначала запросить подтверждение.
При каждом сохранении передаётся значение lastVersion, полученное при предыдущем чтении. Если версия устарела, сохранение отклоняется, чтобы не затереть изменения другого пользователя.
При публикации передаются значения expectedRevisionId и expectedHeadAnchor, полученные при чтении версии, которую проверил пользователь. Если черновик изменился, публикация отклоняется.
При сохранении изменения объединяются по полям; массивы заменяются целиком, а значение null очищает поле. Агент изменяет только то, о чём попросил пользователь.
Для структурных изменений разделов (вставки, удаления, изменения порядка и привязки) используется idempotencyKey: если ответ потерян, запрос можно безопасно повторить.

Навыки

Навык	Назначение	Справочные материалы
getting-started	Подключение клиента, полный список инструментов, разрешения и правила безопасности
website-management	Страницы, разделы, частичные блоки, коллекции, записи, изображения, формы и домены	руководство по разделам (96 типов), примеры сайтов, JSON-каталог разделов
content-creation	Записи в блоге, целевые страницы, записи коллекций и тексты разделов в стиле бренда	критерии качества
design-theming	Цвета темы, шрифты, интервалы, радиус скругления, внешний вид и выбор разделов по стилю	сочетания шрифтов, визуальное руководство по разделам
seo-optimization	Search Console, метаданные, структурированные данные, индексация и редиректы	примеры JSON-LD, спецификации метаданных для соцсетей
analytics-growth	Трафик, эффективность поиска, формы, переходы из AI-сервисов и Web Vitals
site-operations	Проверки перед запуском, порядок публикации, домены, восстановление и мониторинг	контрольный список перед запуском, шаблоны webhook

Агенты

Агент	Назначение
site-manager	Выполняет любые задачи по сайту от начала до конца и поручает узкоспециализированную работу экспертам
seo-specialist	Аудиты, Search Console, метаданные, структурированные данные и редиректы
content-strategist	Создание текстов в стиле бренда и записей коллекций
design-consultant	Темы, типографика, композиция и замена разделов

68 инструментов

Область	Инструменты
Проекты	`list_projects`, `get_project`, `list_domains`, `search_content`
Страницы	`list_pages`, `get_page`, `get_page_content`, `get_page_revisions`, `create_page`, `duplicate_page`, `update_page_meta`, `save_page_content`, `publish_page`, `unpublish_page`, `delete_page`, `revert_page_revision`, `revert_page_revision_to_version`
Разделы	`list_section_types`, `get_section_defaults`, `get_section_content`, `save_section_content`, `insert_section`, `remove_section`, `reorder_sections`, `bind_section_to_collection`, `unbind_section_from_collection`
Коллекции и записи	`list_collections`, `get_collection`, `create_collection`, `update_collection_schema`, `list_entries`, `get_entry`, `create_entry`, `save_entry_content`, `update_entry`, `duplicate_entry`, `publish_entry`, `delete_entry`
Частичные блоки	`list_partials`, `get_partial_content`, `save_partial_content`, `publish_partial`, `unpublish_partial`
SEO и аналитика	`get_gsc_connection_status`, `get_search_performance`, `get_page_index_status`, `get_all_page_statuses`, `inspect_url`, `get_site_analytics`, `get_ai_referral_analytics`
Редиректы	`list_redirects`, `create_redirect`, `update_redirect`, `delete_redirect`
Формы	`list_forms`, `get_form`, `create_form`, `update_form_schema`, `get_form_submissions`
Ресурсы и изображения	`list_assets`, `upload_asset`, `upload_image`, `search_stock_images`, `generate_image`, `get_image_job`, `get_imagegen_quota`
Тема	`get_theme`, `update_theme`

Клиентам Claude доступны 62 инструмента: три инструмента генерации изображений с помощью AI там недоступны, но работают в других клиентах. Инструменты чтения не изменяют данные; инструменты записи содержат подсказки, которые позволяют клиентам запрашивать подтверждение перед выполнением.

Структура репозитория

pixelesq-skills/
├── .claude-plugin/
│   ├── plugin.json            Claude Code plugin manifest
│   └── marketplace.json       lets the repo install as a marketplace
├── .cursor-plugin/plugin.json Cursor plugin manifest
├── .mcp.json                  the connector for Claude Code (http transport)
├── mcp.json                   the same connector in Cursor's format
├── AGENTS.md                  context for agents that read AGENTS.md
├── CHANGELOG.md
├── agents/                    four specialist agents
├── assets/logo.svg
├── scripts/generate-section-guide.mjs
└── skills/
    ├── getting-started/
    ├── website-management/    references: section-catalog.json, section-guide.md, site-recipes.md
    ├── content-creation/      references: quality-rubric.md
    ├── design-theming/        references: font-pairings.md, section-visual-guide.md
    ├── seo-optimization/      references: json-ld-recipes.md, social-meta-specs.md
    ├── analytics-growth/
    └── site-operations/       references: pre-launch-checklist.md, webhook-patterns.md

Актуализация

Руководства по разделам генерируются автоматически. Обновите skills/website-management/references/section-catalog.json на основе данных list_section_types коннектора (все группы, полная детализация), затем запустите node scripts/generate-section-guide.mjs.
Карта инструментов соответствует README коннектора, который генерируется на основе реестра инструментов.
Перед публикацией выполните проверку: claude plugin validate .
Портал плагинов OpenAI принимает skills в виде ZIP-архива. Команда node scripts/build-openai-bundle.mjs создаёт dist/pixelesq-openai-plugin.zip (манифест Agent Plugins и каталог skills/).

Ссылки

Лицензия

MIT