Agent Skill

Connecting an AI client to Lovision MCP gives the agent access to the tools, but not the knowledge of how to use them well. The Lovision agent skill fills that gap: it teaches the agent the canonical session-first workflow, tool routing, hard rules, and error handling before it touches your design.

Without the skill, an agent may call tools in the wrong order, skip required steps like lovision.session.init, miss quality checks, or invent payloads that fail at runtime. With the skill loaded, the agent follows the same workflow a Lovision-aware agent would use by default.

What the Skill Covers

The skill is a Markdown document (skills/lovision-mcp/SKILL.md) that the agent reads before calling any Lovision tool. It covers:

• Session lifecycle — initialize first, finish work at the end, recover on SESSION_NOT_FOUND.
• Canonical workflow — the ordered sequence from session.init through target resolution, context reading, Blueprint design, quality check, preview capture, and finishWork.
• Tool routing — which tool to call for each task: session, workspace, document, pages, Blueprint, quality, fonts, tokens, media, and export.
• Hard rules — write only through Host Facade backed tools, prefer Blueprint for complex design work, include expectedVersion and idempotencyKey on writes, verify after meaningful edits.
• Capability and error handling — how to read capability profiles, handle PERMISSION_DENIED, CAPABILITY_NOT_AVAILABLE, RATE_LIMITED, and other structured errors.
• Media ladder — how to acquire and insert images correctly: Lovision generation first, licensed fallback second, explicit placeholder last.

Install

The skill is distributed from choice-form/lovision-mcp-skills. Each agent client has its own install path.

Claude Code

Install the plugin, which registers Lovision MCP and loads the skill:

claude /plugin marketplace add choice-form/lovision-mcp-skills
claude /plugin install lovision

If Lovision MCP is already configured and you only want the skill:

npx skills add choice-form/lovision-mcp-skills --skill lovision-mcp -a claude-code

Cursor

/add-plugin choice-form/lovision-mcp-skills

Cursor reads the plugin manifest, installs the skill, and registers the MCP server. Skills only:

npx skills add choice-form/lovision-mcp-skills --skill lovision-mcp -a cursor

Codex

codex mcp add lovision --url https://mcp.lovision.ai/
codex mcp login lovision
npx skills add choice-form/lovision-mcp-skills --skill lovision-mcp -a codex

Gemini CLI

gemini extensions install https://github.com/choice-form/lovision-mcp-skills
gemini /mcp auth lovision

Other agents

For clients that do not support plugin manifests, include the skill content directly in the agent prompt:

@include skills/lovision-mcp/SKILL.md

Or copy the raw content from skills/lovision-mcp/SKILL.md into your system prompt or project instructions file.

How It Works

The agent skill uses the same mechanism as a CLAUDE.md or Cursor rules file: it is injected into the agent's context before the conversation starts. When the agent sees a Lovision-related request, it reads the skill content and follows the workflow defined there.

The skill is trigger-based. The description field on the skill file tells the agent when to apply it:

Use whenever the Lovision MCP server is connected or the user mentions Lovision, lovision.ai, mcp.lovision.ai, Lovision Desktop Local MCP, a Lovision project, document, canvas, Blueprint design generation, project workspace operations, quality checks, preview, export, or asks an external agent to create, inspect, modify, or hand off native Lovision design work.

The agent applies the skill automatically for any Lovision-related task. You do not need to ask it to follow the workflow explicitly.

Keeping the Skill Up to Date

The skill is maintained alongside the Lovision MCP server. When new tools are added or the workflow changes, the skill is updated in the monorepo and automatically synced to choice-form/lovision-mcp-skills.

To get the latest skill, re-run the install command for your client, or pull the latest version of the skills repository.

Related

• Connect Lovision MCP — Connect your AI client to Lovision.
• Lovision MCP Tools — See what each tool group can do.