Pixelesq Agent Skills
Manage websites built on Pixelesq from any AI agent. Build and edit pages section by section, write content into collections, tune SEO and structured data, read Search Console and site analytics, manage redirects and images, restyle the theme, and publish when the user says so.
This repository is three things at once:
- Seven skills in the Agent Skills format, loaded by Claude Code, Cursor, Codex, Copilot, Gemini CLI, Goose and other compatible agents.
- Four specialist agents for Claude Code (and any platform that reads
agents/*.md). - The Pixelesq MCP connector, declared in
.mcp.json:https://mcp.pixelesq.app/mcp, 68 tools, OAuth sign-in with your Pixelesq account.
Install
Claude Code (plugin)
/plugin marketplace add pixelesq/pixelesq-skills
/plugin install pixelesq@pixelesq
Then run /mcp and sign in to Pixelesq. The skills load on demand, the agents are available as @pixelesq:site-manager, @pixelesq:seo-specialist, @pixelesq:content-strategist and @pixelesq:design-consultant, and the connector is registered from .mcp.json.
Claude Code (connector only)
claude mcp add --transport http pixelesq https://mcp.pixelesq.app/mcp
Claude.ai and Claude Desktop
Settings, Connectors, Add custom connector, paste https://mcp.pixelesq.app/mcp, sign in.
ChatGPT
Settings, Apps & Connectors, Advanced, developer mode, Create, paste https://mcp.pixelesq.app/mcp.
Cursor
Install the plugin from the Cursor Marketplace, or add the server to mcp.json:
{ "mcpServers": { "pixelesq": { "url": "https://mcp.pixelesq.app/mcp" } } }
VS Code
{ "servers": { "pixelesq": { "type": "http", "url": "https://mcp.pixelesq.app/mcp" } } }
Other platforms
Clone the repository, point the agent's skills directory at skills/, and configure the MCP server URL https://mcp.pixelesq.app/mcp. Clients register dynamically or present a client ID metadata document; both are accepted.
Sign-in and scopes
The connector uses OAuth 2.1 with PKCE. Sign in with Google or with a Pixelesq email and the code it sends. A Pixelesq account with at least one project is required; sign up at https://app.pixelesq.ai.
Scopes are granted at sign-in and stamped into the token: projects:read, content:read, content:write, publish, analytics:read. A tool outside the grant answers with a refusal that asks the client to reconnect.
How edits stay safe
- Every save changes a draft. The live site changes only through
publish_page,publish_partial,publish_entry,update_themewithpublish: trueandupdate_form_schema(a form has no draft), and the skills tell the agent to confirm first. - Every save carries the
lastVersionfrom the read before it; a stale version is refused instead of overwriting someone else's work. - A publish carries
expectedRevisionIdandexpectedHeadAnchorfrom the read the user reviewed, and refuses if the draft moved. - Saves merge field by field, arrays replace whole,
nullclears a field. The agent only touches what the user asked for. - Structural section edits (insert, remove, reorder, bind) take an
idempotencyKeyso a lost answer can be retried safely.
Skills
Agents
The 68 tools
Claude clients are offered 62 of these: the three AI image generation tools are withheld there and available in other clients. Read tools change nothing; write tools carry the hints that let clients ask before running them.
Repository layout
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
Keeping it current
- The section guides are generated. Refresh
skills/website-management/references/section-catalog.jsonfrom the connector'slist_section_types(all groups, full detail), then runnode scripts/generate-section-guide.mjs. - The tool map mirrors the connector's README, which is generated from the tool registry.
- Validate before publishing:
claude plugin validate . - The OpenAI plugin portal takes the skills as a ZIP:
node scripts/build-openai-bundle.mjswritesdist/pixelesq-openai-plugin.zip(an Agent Plugins manifest plusskills/).
Links
License
MIT