openclaw - ✅(Solved) Fix canvas skill: Missing required YAML frontmatter [1 pull requests, 1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#54310Fetched 2026-04-08 01:29:14
View on GitHub
Comments
0
Participants
1
Timeline
1
Reactions
0
Participants
Timeline (top)
cross-referenced ×1

Fix Action

Fixed

PR fix notes

PR #54361: fix(skills): add canvas frontmatter

Description (problem / solution / changelog)

Summary

  • add required YAML frontmatter to the bundled canvas skill
  • include a trigger-oriented description so the skill can be indexed and selected

Closes #54310

Changed files

  • skills/canvas/SKILL.md (modified, +5/-0)

Code Example

---
name: canvas
description: Display HTML content on connected OpenClaw nodes (Mac app, iOS, Android). Use when user asks to "show this on my phone", "display on canvas", "present HTML", or needs to render interactive content on a connected device.
---
RAW_BUFFERClick to expand / collapse

Canvas Skill Quality Issues

The bundled canvas skill has several quality issues that prevent it from following OpenClaw skill standards:

Missing Frontmatter

The skill has no YAML frontmatter at all. It starts directly with # Canvas Skill instead of the required:

---
name: canvas
description: Display HTML content on connected OpenClaw nodes (Mac app, iOS, Android). Use when user asks to "show this on my phone", "display on canvas", "present HTML", or needs to render interactive content on a connected device.
---

Missing Description Triggers

Even if frontmatter were added, the current content lacks specific trigger phrases. The description should include WHEN to use the skill with concrete examples like:

  • "show this on my phone"
  • "display on canvas"
  • "present HTML"
  • "render this interactive demo"

Size Concerns

The skill is quite verbose with extensive architecture diagrams and debugging sections. Consider:

  • Moving detailed debugging steps to a references/troubleshooting.md file
  • Condensing the architecture section
  • Using progressive disclosure to keep SKILL.md lean

Recommended Fix

  1. Add proper YAML frontmatter with name and trigger-rich description
  2. Validate with validate_skill.py to ensure compliance
  3. Consider splitting detailed troubleshooting into references/
  4. Test the skill trigger matching with a typical user request

Impact

Without frontmatter, this skill cannot be properly indexed or triggered by the agent system. It's currently invisible to the skill selection mechanism.

extent analysis

Fix Plan

To address the quality issues with the canvas skill, follow these steps:

  1. Add YAML frontmatter: Insert the required frontmatter at the beginning of the skill file:
---
name: canvas
description: Display HTML content on connected OpenClaw nodes (Mac app, iOS, Android). Use when user asks to "show this on my phone", "display on canvas", "present HTML", or needs to render interactive content on a connected device.
---
  1. Enhance description with trigger phrases: Update the description to include specific trigger phrases, such as:
# Canvas Skill
Display HTML content on connected OpenClaw nodes (Mac app, iOS, Android). Use when user asks to:
* "show this on my phone"
* "display on canvas"
* "present HTML"
* "render this interactive demo"
  1. Refactor content for size and readability:
    • Move detailed debugging steps to a references/troubleshooting.md file.
    • Condense the architecture section.
    • Use progressive disclosure to keep the SKILL.md file lean.

Verification

To verify the fix, run the validate_skill.py script to ensure compliance with OpenClaw skill standards. Additionally, test the skill trigger matching with a typical user request, such as "show this on my phone", to confirm that the skill is properly indexed and triggered by the agent system.

Example Code

The updated SKILL.md file should resemble:

---
name: canvas
description: Display HTML content on connected OpenClaw nodes (Mac app, iOS, Android). Use when user asks to "show this on my phone", "display on canvas", "present HTML", or needs to render interactive content on a connected device.
---
# Canvas Skill
Display HTML content on connected OpenClaw nodes (Mac app, iOS, Android). Use when user asks to:
* "show this on my phone"
* "display on canvas"
* "present HTML"
* "render this interactive demo"

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

openclaw - ✅(Solved) Fix canvas skill: Missing required YAML frontmatter [1 pull requests, 1 participants]