Agent Skills › zhongerxin/Cowart › cowart-open-canvas

cowart-open-canvas

GitHub

当用户要求打开、重新打开或刷新 Cowart 画布，或触发裸 @Cowart 调用时，通过 MCP 服务器调用 render_cowart_canvas_widget 工具来渲染画布组件。

skills/cowart-open-canvas/SKILL.md zhongerxin/Cowart

触发场景

用户要求打开或刷新画布发起无其他请求的 @Cowart 调用

安装

npx skills add zhongerxin/Cowart --skill cowart-open-canvas -g -y

更多选项

不安装直接使用

npx skills use zhongerxin/Cowart@cowart-open-canvas

指定 Agent (Claude Code)

npx skills add zhongerxin/Cowart --skill cowart-open-canvas -a claude-code -g -y

安装 repo 全部 skill

npx skills add zhongerxin/Cowart --all -g -y

预览 repo 内 skill

npx skills add zhongerxin/Cowart --list

SKILL.md

Frontmatter

{
    "name": "cowart-open-canvas",
    "description": "Open, reopen, or explicitly refresh the native Cowart canvas when the user asks to see it, or when a bare @Cowart invocation has no other requested workflow."
}

Cowart Open Canvas

The actual canvas-opening capability is the cowart_mcp MCP server and its render_cowart_canvas_widget tool. Use this skill when the user asks to open, reopen, or explicitly refresh the canvas. A bare @Cowart invocation with no other actionable request may also open the canvas. Do not use this skill as a prerequisite for image generation, annotation editing, HTML, Slides, or follow-up requests sent from an already-open Cowart widget.

Workflow

Ensure the cowart_mcp MCP server is loaded or discoverable and that its render_cowart_canvas_widget tool is available. The host may expose the complete tool name as mcp__cowart_mcp__render_cowart_canvas_widget. Call the tool once for the user's open, reopen, or explicit refresh request. Pass the user's active Codex workspace as projectDir; do not pass the Cowart plugin repository directory.

{
  "projectDir": "/absolute/path/to/user/codex-project"
}

The tool returns openai/outputTemplate: ui://widget/cowart/canvas.html, which tells Codex to render the widget directly. Do not start scripts/start-canvas.sh or open a localhost URL for normal use.

Confirm the widget opens for the user. The canvas data is stored in the active project:

canvas/pages/<page-id>/cowart-canvas.json
canvas/pages/<page-id>/assets/

If the MCP tool is not visible in the current turn, use tool discovery for Cowart widget/render capabilities and retry within the same task after an explicit Cowart canvas invocation. Do not claim that a new task is required merely because one turn did not expose the tool. Only suggest a new Codex task when the plugin was just installed or upgraded and the MCP schema is still unavailable after discovery and an explicit retry.

Constraints

Do not call render_cowart_canvas_widget again merely because another Cowart skill applies or an existing widget sends a follow-up request. The existing widget synchronizes MCP-backed canvas changes itself. Do not launch the old local web service, inspect canvas files, run builds, check storage layout, take screenshots, or perform other validation steps unless opening the widget fails or the user explicitly asks for those checks. The scripts/start-canvas.sh path is now only a local-development fallback.