YAML parsing errors in skills/agents cause TUI crashes #4997

Closed
opened 2026-02-16 17:47:30 -05:00 by yindo · 0 comments
Owner

Originally created by @vvarp on GitHub (Jan 12, 2026).

Originally assigned to: @rekram1-node on GitHub.

Description

When a SKILL.md, command, or agent file contains error in frontmatter YAML portion of markdown file, the TUI crashes with a fullscreen ConfigFrontmatterError that covers the entire interface. In the desktop/web version no error message is being shown.

Example of problematic frontmatter (unquoted : in the description field):

---
name: test-skill
description: Use this skill for testing stuff. Reference: https://example.com
---

Plugins

No response

OpenCode version

latest dev branch

Steps to reproduce

  1. Create a skill file at .opencode/skill/test/SKILL.md:
---
name: test-skill
description: Use this skill for testing stuff. Reference: https://example.com
---
  1. Run opencode
  2. Send any message to see TUI crash with fullscreen ConfigFrontmatterError

Screenshot and/or share link

Notice the error message covering bottom part of TUI:

Image

Operating System

macOS Tahoe

Terminal

Any

Originally created by @vvarp on GitHub (Jan 12, 2026). Originally assigned to: @rekram1-node on GitHub. ### Description When a `SKILL.md`, command, or agent file contains error in frontmatter YAML portion of markdown file, the TUI crashes with a fullscreen ConfigFrontmatterError that covers the entire interface. In the desktop/web version no error message is being shown. Example of problematic frontmatter (unquoted `:` in the description field): ``` --- name: test-skill description: Use this skill for testing stuff. Reference: https://example.com --- ``` ### Plugins _No response_ ### OpenCode version latest dev branch ### Steps to reproduce 1. Create a skill file at .opencode/skill/test/SKILL.md: ``` --- name: test-skill description: Use this skill for testing stuff. Reference: https://example.com --- ``` 2. Run opencode 3. Send any message to see TUI crash with fullscreen ConfigFrontmatterError ### Screenshot and/or share link Notice the error message covering bottom part of TUI: <img width="1902" height="483" alt="Image" src="https://github.com/user-attachments/assets/564ac380-fd5c-4212-adcd-c46ba8364c9f" /> ### Operating System macOS Tahoe ### Terminal Any
yindo added the opentuibug labels 2026-02-16 17:47:30 -05:00
yindo closed this issue 2026-02-16 17:47:30 -05:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#4997