anomalyco/opencode
1
0
Fork 0
mirror of https://github.com/anomalyco/opencode.git synced 2026-07-22 02:05:26 -04:00
Code Issues 5.9k Packages Projects Releases 19 Wiki Activity

ConfigFrontmatterError when parsing Claude Code SKILL.md with 'arguments' field #5888

New Issue
Closed
opened 2026-02-16 17:58:00 -05:00 by yindo · 0 comments
yindo commented 2026-02-16 17:58:00 -05:00
Owner
Copy Link
Copy Source

Originally created by @corrius on GitHub (Jan 14, 2026).

Originally assigned to: @rekram1-node on GitHub.

Bug Description

OpenCode crashes with ConfigFrontmatterError when it discovers Claude Code skills that contain the arguments field in their YAML frontmatter.

Environment

  • OpenCode version: 1.1.20
  • OS: Linux (Arch Linux 6.18.3)
  • Claude Code skills location: ~/.claude/skills/

Error Message

ConfigFrontmatterError: ConfigFrontmatterError
  data:
    path: "/home/user/.claude/skills/aws-sso/SKILL.md",
    message: "Failed to parse YAML frontmatter: incomplete explicit mapping pair; a key node is missed; or followed by a non-tabulated empty line at line 9, column 52"

Steps to Reproduce

  1. Have Claude Code installed with custom skills in ~/.claude/skills/
  2. Skills contain YAML frontmatter with arguments field (standard Claude Code format)
  3. Run opencode in any directory
  4. OpenCode crashes immediately with the frontmatter error

Example SKILL.md That Causes the Error

---
name: aws-sso
description: Login to AWS SSO using Chrome browser automation
user_invocable: true
invocation_syntax: "/aws-sso [profile]"
model: haiku
arguments:
  - name: profile
    description: AWS profile to login with (default: adri-dev)
    required: false
---

# AWS SSO Login Skill
...

Expected Behavior

OpenCode should either:

  1. Gracefully skip skills with unrecognized frontmatter fields
  2. Support Claude Code's arguments syntax for compatibility
  3. Provide a way to exclude directories from skill discovery

Related Issues

  • #6177 - Skill discovery directory structure mismatch
  • #6266 - Does opencode actually support finding skills at .claude/skills?
  • #6400 - Support discovering Global Claude skills

Workaround

Currently none - the only option is to rename/move the ~/.claude/skills/ directory which breaks Claude Code.

Originally created by @corrius on GitHub (Jan 14, 2026). Originally assigned to: @rekram1-node on GitHub. ## Bug Description OpenCode crashes with `ConfigFrontmatterError` when it discovers Claude Code skills that contain the `arguments` field in their YAML frontmatter. ## Environment - OpenCode version: 1.1.20 - OS: Linux (Arch Linux 6.18.3) - Claude Code skills location: `~/.claude/skills/` ## Error Message ``` ConfigFrontmatterError: ConfigFrontmatterError data: path: "/home/user/.claude/skills/aws-sso/SKILL.md", message: "Failed to parse YAML frontmatter: incomplete explicit mapping pair; a key node is missed; or followed by a non-tabulated empty line at line 9, column 52" ``` ## Steps to Reproduce 1. Have Claude Code installed with custom skills in `~/.claude/skills/` 2. Skills contain YAML frontmatter with `arguments` field (standard Claude Code format) 3. Run `opencode` in any directory 4. OpenCode crashes immediately with the frontmatter error ## Example SKILL.md That Causes the Error ```markdown --- name: aws-sso description: Login to AWS SSO using Chrome browser automation user_invocable: true invocation_syntax: "/aws-sso [profile]" model: haiku arguments: - name: profile description: AWS profile to login with (default: adri-dev) required: false --- # AWS SSO Login Skill ... ``` ## Expected Behavior OpenCode should either: 1. Gracefully skip skills with unrecognized frontmatter fields 2. Support Claude Code's `arguments` syntax for compatibility 3. Provide a way to exclude directories from skill discovery ## Related Issues - #6177 - Skill discovery directory structure mismatch - #6266 - Does opencode actually support finding skills at `.claude/skills`? - #6400 - Support discovering Global Claude skills ## Workaround Currently none - the only option is to rename/move the `~/.claude/skills/` directory which breaks Claude Code.
yindo closed this issue 2026-02-16 17:58:00 -05:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
acp
bad
bug
discussion
docs
documentation
enhancement
extension
good first issue
growth
help-wanted
mcp
model-problem
needs:compliance
nix
opentui
perf
pull-request
Mirrored from GitHub Pull Request
 tui
web
windows
zen
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
yindo
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#5888
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?