Pixelesq

Pixelesq エージェントスキル

あらゆる AI エージェントから Pixelesq で構築されたウェブサイトを管理できます。セクションごとにページを作成・編集したり、コレクションにコンテンツを書き込んだり、SEO や構造化データを調整したり、Search Console やサイト分析を確認したり、リダイレクトや画像を管理したり、テーマのスタイルを変更したりできます。ユーザーから指示があったら公開できます。

このリポジトリは、次の3つの役割を兼ねています。

• 7つのスキル。Agent Skills 形式で、Claude Code、Cursor、Codex、Copilot、Gemini CLI、Goose などの互換性のあるエージェントが読み込みます。
• 4つの専門エージェント。Claude Code 用（および agents/*.md を読み込むすべてのプラットフォーム用）です。
• Pixelesq MCP コネクター。.mcp.json で宣言されており、URL は https://mcp.pixelesq.app/mcp、ツールは68個です。Pixelesq アカウントで OAuth サインインします。

インストール

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/ を指定して、MCP サーバーの URL https://mcp.pixelesq.app/mcp を設定します。クライアントは動的に登録するか、クライアント ID のメタデータドキュメントを提示します。どちらも受け付けられます。

サインインとスコープ

コネクターは PKCE を用いた OAuth 2.1 を使用します。Google、または Pixelesq のメールアドレスと送信されるコードでサインインします。プロジェクトを1つ以上持つ Pixelesq アカウントが必要です。https://app.pixelesq.ai から登録できます。

スコープはサインイン時に付与され、トークンに記録されます。projects:read、content:read、content:write、publish、analytics:read が対象です。付与されていないスコープを必要とするツールは、クライアントに再接続を求める拒否応答を返します。

編集の安全性

• 保存するたびに下書きが変更されます。公開中のサイトが変更されるのは、publish_page、publish_partial、publish_entry、publish: true を指定した update_theme、および 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 画像生成ツール 3 個は Claude クライアントでは利用できず、ほかのクライアントで利用できます。読み取りツールは何も変更しません。書き込みツールには、実行前に確認するようクライアントに促すヒントが含まれています。

リポジトリの構成

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

最新の状態を保つ

• セクションガイドは生成されます。コネクターの list_section_types（すべてのグループ、詳細情報をすべて含む）から skills/website-management/references/section-catalog.json を更新し、node scripts/generate-section-guide.mjs を実行します。
• ツール一覧は、ツールレジストリから生成されるコネクターの README に準拠しています。
• 公開前に検証します：claude plugin validate .
• OpenAI プラグインポータルには、スキルを ZIP 形式で登録します：node scripts/build-openai-bundle.mjs を実行すると、dist/pixelesq-openai-plugin.zip（Agent Plugins マニフェストと skills/）が作成されます。

Links

• Pixelesq
• Connector documentation
• Agent Skills
• Model Context Protocol
• Privacy policy and terms

License

MIT