Issue Station
Sign In
Tools hereToolbox

openclaw - ✅(Solved) Fix [Bug]: bundled taskflow-inbox-triage skill ships with malformed 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#64462•Fetched 2026-04-11 06:14:52
View on GitHub
Comments
0
Participants
1
Timeline
3
Reactions
0
Author
ismael-81ismael-81
Participants
ismael-81ismael-81
Timeline (top)
closed ×1cross-referenced ×1referenced ×1

The bundled taskflow-inbox-triage skill ships with malformed YAML frontmatter in SKILL.md.

The file currently starts with metadata keys directly:

name: taskflow-inbox-triage
description: ...
metadata: ...

---
# TaskFlow inbox triage

Instead of starting with a valid YAML frontmatter block:

---
name: taskflow-inbox-triage
description: ...
metadata: ...
---
# TaskFlow inbox triage

Because of that, the bundled skill is not parsed as valid frontmatter by the skill loader and can disappear from skill discovery/status surfaces unless manually patched on disk.

Root Cause

Because of that, the bundled skill is not parsed as valid frontmatter by the skill loader and can disappear from skill discovery/status surfaces unless manually patched on disk.

Fix Action

Fix / Workaround

Because of that, the bundled skill is not parsed as valid frontmatter by the skill loader and can disappear from skill discovery/status surfaces unless manually patched on disk.

PR fix notes

PR #64469: fix(skills): add missing opening --- to taskflow and taskflow-inbox-triage SKILL.md frontmatter

Description (problem / solution / changelog)

Problem

The bundled taskflow and taskflow-inbox-triage skills ship with malformed YAML frontmatter — both files start directly with metadata keys (name:, description:, etc.) instead of opening with ---.

A valid YAML frontmatter block requires an opening delimiter:

---
name: taskflow
description: ...
metadata: ...
---

Without it, the skill loader cannot parse the frontmatter, which can cause skills to silently disappear from discovery and skill-loading surfaces. Any manual local fix is overwritten on the next openclaw update since the files live under the installed package tree.

Fix

Add the missing opening --- to:

  • skills/taskflow/SKILL.md
  • skills/taskflow-inbox-triage/SKILL.md

Two-line change, no logic touched.

Testing

Confirmed both files now have valid --- ... --- bounded frontmatter blocks. Verified against other bundled skills that load correctly (e.g. skills/weather/SKILL.md).

Closes #64461, closes #64462

Changed files

  • CHANGELOG.md (modified, +1/-0)
  • skills/taskflow-inbox-triage/SKILL.md (modified, +1/-0)
  • skills/taskflow/SKILL.md (modified, +1/-0)
  • src/agents/skills.bundled-frontmatter.test.ts (added, +24/-0)

Code Example

name: taskflow-inbox-triage
description: ...
metadata: ...

---
# TaskFlow inbox triage

---

---
name: taskflow-inbox-triage
description: ...
metadata: ...
---
# TaskFlow inbox triage

---

---
name: taskflow-inbox-triage
description: ...
metadata: ...
---
RAW_BUFFERClick to expand / collapse

Bug type

Backend / Skills

Summary

The bundled taskflow-inbox-triage skill ships with malformed YAML frontmatter in SKILL.md.

The file currently starts with metadata keys directly:

name: taskflow-inbox-triage
description: ...
metadata: ...

---
# TaskFlow inbox triage

Instead of starting with a valid YAML frontmatter block:

---
name: taskflow-inbox-triage
description: ...
metadata: ...
---
# TaskFlow inbox triage

Because of that, the bundled skill is not parsed as valid frontmatter by the skill loader and can disappear from skill discovery/status surfaces unless manually patched on disk.

Steps to reproduce

  1. Install/update OpenClaw from the current packaged release.
  2. Inspect:
    • ~/.npm-global/lib/node_modules/openclaw/skills/taskflow-inbox-triage/SKILL.md
  3. Observe the file begins with name: instead of opening ---.
  4. Compare with bundled skills that load correctly.
  5. Manually add the missing opening --- and keep the closing --- after metadata.
  6. Observe the skill becomes structurally valid again.

Expected behavior

Bundled skills should ship with valid YAML frontmatter:

---
name: taskflow-inbox-triage
description: ...
metadata: ...
---

Actual behavior

taskflow-inbox-triage/SKILL.md is packaged with malformed frontmatter and requires manual repair after install/update.

Impact

  • bundled skill can silently disappear from discovery/skill-loading surfaces
  • manual local fixes are overwritten by later updates because the file lives under the installed package tree
  • users may think the skill system is unstable when the root cause is a malformed bundled file

Minimal fix

Add the missing opening --- at the very top of:

  • skills/taskflow-inbox-triage/SKILL.md

OpenClaw version

Observed on v2026.4.9

Operating system

Linux

extent analysis

TL;DR

Add the missing opening --- at the top of the SKILL.md file in the taskflow-inbox-triage skill to fix the malformed YAML frontmatter.

Guidance

  • Verify the issue by checking the SKILL.md file in the taskflow-inbox-triage skill and looking for the missing opening ---.
  • Manually add the opening --- to the top of the SKILL.md file to temporarily fix the issue.
  • To prevent the manual fix from being overwritten by later updates, consider modifying the skill packaging process to include the correct YAML frontmatter.
  • Check other bundled skills for similar issues with malformed YAML frontmatter.

Example

The corrected SKILL.md file should look like this:

---
name: taskflow-inbox-triage
description: ...
metadata: ...
---
# TaskFlow inbox triage

Notes

This fix only addresses the specific issue with the taskflow-inbox-triage skill and may not apply to other skills with similar problems.

Recommendation

Apply the workaround by adding the missing opening --- to the SKILL.md file, as this is a simple and effective fix for the immediate issue.

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…

FAQ

Expected behavior

Bundled skills should ship with valid YAML frontmatter:

---
name: taskflow-inbox-triage
description: ...
metadata: ...
---
#api#ssr#installation#tensor shape#request timeout

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 [Bug]: bundled taskflow-inbox-triage skill ships with malformed YAML frontmatter [1 pull requests, 1 participants]