Repository navigation
Bug: SkillInvalidError during frontmatter parsing in SKILL.md #5991
Description
Description
Description
PLEASE NOTE: This worked fine 12 hours ago, prior to one of your latest updates... I have even removed that skill and then the next skill has issues.... claude works fine.
An unhandled or validation-driven SkillInvalidError is triggered when loading a skill. The error occurs during the frontmatter parsing stage in src/skill/skill.ts. It appears that the SKILL.md file for the pair-programming skill contains frontmatter that does not conform to the Frontmatter schema (likely a Zod safeParse failure).
Error Details
- Error Type:
SkillInvalidError - Location:
src/skill/skill.ts:110:13 - Affected File:
~/.claude/skills/pair-programming/SKILL.md - Context:
Frontmatter.safeParse(md.data)returnedsuccess: false.
Stack Trace / Logs
108 | const parsed = Frontmatter.safeParse(md.data)
109 | if (!parsed.success) {
110 | throw new InvalidError({
^
SkillInvalidError: SkillInvalidError
data: {
path: "/Users/{project_name}/PycharmProjects/lexgenius/.claude/skills/pair-programming/SKILL.md",
issues: [
[Object ...] // Validation issues in the markdown frontmatter
],
},
at load (src/skill/skill.ts:110:13)Steps to Reproduce
- Run the
opencode. - The system attempts to load the
pair-programmingskill from.claude/skills/pair-programming/SKILL.md. - The loader fails because the markdown frontmatter (YAML) is either missing required fields or has incorrect data types.
- This worked PRIOR to opencode's last update.
Possible Causes
- Malformed YAML: The frontmatter in
SKILL.mdhas syntax errors. - Schema Mismatch: The
FrontmatterZod schema in the codebase was updated, but theSKILL.mdfile was not updated to match. - Empty Fields: Required fields like
name,description, orversionmight be missing.
Proposed Solution
- Inspect the
issuesarray in the console log to identify specifically which field in theSKILL.mdfrontmatter is failing validation. - Update
SKILL.mdto match the required schema. - Add better error logging in
src/skill/skill.tsto print the specific Zod validation errors (formatted) instead of just[Object ...].
OpenCode version
No response
Steps to reproduce
No response
Screenshot and/or share link
No response
Operating System
No response
Terminal
No response
Activity
rekram1-node commentedon Dec 22, 2025
can u share ur skill plz?
GratefulDave commentedon Dec 22, 2025
This resolved with your latest update.
malhashemi commentedon Dec 22, 2025
Hey @rekram1-node I think I found the skill that is causing the crash, that is
https://github.com/ruvnet/claude-flow/blob/87cc5634085b4696daba0bd2e63c09745aa0b90b/.claude/skills/pair-programming/SKILL.md?plain=1it only worked after your update cause you are not reading from claude directory. If that skill gets moved to.opencode/skillsit would still crash opencode. I am investigating the validation logicrekram1-node commentedon Dec 22, 2025
Yeah that was intentional i just disabled the claude ones
malhashemi commentedon Dec 22, 2025
@GratefulDave The issue is not with OpenCode implementation it is with ClaudeCode not following their own standards in validating skill
From
https://agentskills.io/specification#name-fieldThe skill you are referring to is using
name: Pair Programmingbut it seems CC does not enforce the specs!malhashemi commentedon Dec 22, 2025
@rekram1-node / @thdxr this could cause many skills coming from Claude to crash, if you have connections in Anthropic, they either enforce the specs in CC or adjust the name field in the specs to allow for spaces. Or we just loosen the validation on OpenCode side not following the specs similar to them haha