Uniform agent skills

Agent skills and MCP configuration that help AI coding agents build with Uniform. Ships as a plugin for Claude Code, Cursor, Codex, and GitHub Copilot, and as plain Agent Skills for any other agent that reads SKILL.md.

What you get

• Skills — task-scoped guidance, progressively disclosed. Only each skill's name and description sit in the agent's context at startup; the body loads when the agent decides it is relevant.
• Uniform MCP server — configured by the plugin, so the agent can create and edit components, patterns, and content through the API instead of hand-editing uniform-data files.

Install

Claude Code and GitHub Copilot are verified end to end. Cursor and Codex read the same generated manifests but are exercised less — Codex plugin support also needs a recent CLI. If an install path does not work on your version, use a local checkout and please open an issue.

Claude Code

/plugin marketplace add uniformdev/agent-skills
/plugin install uniformdev

The skills work immediately, with nothing to configure. To also use the Uniform MCP server, run /plugin configure and supply your project ID and API key — Claude stores the key in your system keychain. Until then the server is listed but will not connect.

Cursor

Dashboard → Plugins → Add Marketplace → import uniformdev/agent-skills, then install the Uniform plugin. Enable Auto Refresh to pick up new commits. Set UNIFORM_PROJECT_ID and UNIFORM_API_KEY in your environment so the MCP server can authenticate.

Codex

This repository doubles as a Codex marketplace via .agents/plugins/marketplace.json. Add it as a marketplace source and install the uniform plugin. Credentials come from the same two environment variables as Cursor.

GitHub Copilot

Copilot reads the portable Agent Plugins manifest at the repository root, so a checkout loads directly:

copilot --plugin-dir /path/to/agent-skills

You get the skills only. The portable manifest deliberately ships no MCP configuration — the specification forbids putting a credential in one — so configure the Uniform MCP server yourself if you want it.

Any other agent

Many agents read SKILL.md natively. Install the skills alone with:

npx skills add uniformdev/agent-skills

npx skills update refreshes them. This installs skills only, not MCP.

From a local checkout

Useful when working on the plugin itself:

• Claude Code — /plugin marketplace add /path/to/agent-skills, then /plugin install uniformdev
• Cursor — copy the repository into ~/.cursor/plugins/local
• Codex — add /path/to/agent-skills/.agents/plugins/marketplace.json as a marketplace source
• GitHub Copilot — copilot --plugin-dir /path/to/agent-skills

MCP credentials

None of these are required to install. The skills need no credentials at all — configure these only when you want the MCP server, and the plugin will not ask for them up front.

Variable	What it is
UNIFORM_PROJECT_ID	Your Uniform project ID
UNIFORM_API_KEY	Service Account key or Personal Access Token with the Developer role
UNIFORM_AI_HOST	Region-specific MCP host. Defaults to ai.uniform.global

The project ID and API key are available in the Uniform dashboard via Copy as mcp json. The MCP server needs both; with either missing it is listed but cannot connect. Endpoints are region-specific — see Regions and data residency if your team is not on the default host.

Skills

Skill	What it covers
uniform-assets	Working with Uniform image/media assets end to end — defining an asset parameter, rendering an image src with imageFrom (the graceful, future-proof default), reading other…
uniform-automations	Uniform Automations (defineAutomation, defineScoutAutomation, ScoutClient, *.automation.ts).
uniform-content-modeling	Best practices for content modeling in Uniform — designing content types with well-chosen fields, validations, and naming, deciding what belongs in structured content vs the…
uniform-enrichment-recommendations	Add personalized, relevance-ranked content recommendations to a Uniform + React/Next.js project by boosting Content API results with Uniform Context enrichment scores.
uniform-experience-modeling	Best practices for experience modeling in Uniform — designing component definitions with well-chosen parameters, slots, editors, and naming, deciding between slots and parameters…
uniform-forms	Use when adding a form (like contact, signup, newsletter, lead-capture or survey) to a Uniform project, when creating form field component definitions or building a generic form…
uniform-mesh	Building Uniform Mesh integrations end to end — scaffold with the CLI, define the mesh-manifest, implement locations, register/install and deploy — plus how to discover and use…
uniform-navigation	Model and build header navigation in Uniform — authored, reorderable nav items, dropdown flyouts, mega-menu panels with a category rail and promo area, and mobile drawers.
uniform-nextjs-app-router	Guides integration of Uniform CMS with Next.js App Router using the @uniformdev/next-app-router v2 SDK and React Server Components.
uniform-nextjs-page-router	Guides integration of Uniform CMS with Next.js Page Router.
uniform-sdk	Uniform SDK developer reference covering authentication, CLI configuration, routing, and the content API clients that read and write compositions, entries, and content types.

Repository layout

skills/             # the skills, one directory per topic (Agent Skills format)
plugin.source.json  # source of truth for every plugin manifest
scripts/            # manifest generator and skill validator
evals/              # A/B eval harness measuring whether the skills help
generated/          # build output — never edit by hand

The repository root is the plugin root: agents read skills/ and then either the portable plugin.json or their own .claude-plugin/, .cursor-plugin/, or .codex-plugin/ manifest, and ignore everything else.

Contributing

Contributions are welcome — a new skill for a framework we do not cover yet, a correction to an existing one, or a new eval. See CONTRIBUTING.md for the authoring standard and the build steps. In short:

npm install
npm run validate        # every skill passes the Agent Skills spec
npm run build:plugins   # regenerate the plugin manifests after editing plugin.source.json

Resources

• Uniform documentation
• Uniform MCP server
• Agent Skills specification

License: MIT