Skip to content

fix(skill): make SKILL.md frontmatter compatible with OpenCode - #462

Closed
syf2211 wants to merge 1 commit into
Panniantong:mainfrom
syf2211:fix/opencode-skill-frontmatter
Closed

fix(skill): make SKILL.md frontmatter compatible with OpenCode#462
syf2211 wants to merge 1 commit into
Panniantong:mainfrom
syf2211:fix/opencode-skill-frontmatter

Conversation

@syf2211

@syf2211 syf2211 commented Jul 2, 2026

Copy link
Copy Markdown

Summary

Fixes OpenCode "Unknown text label" warnings when Agent Reach is installed as a skill.

Motivation

OpenCode only recognizes a small set of SKILL.md frontmatter fields (name, description, license, compatibility, and flat string metadata). The bundled skill used a triggers field and nested metadata.openclaw.homepage, which OpenCode surfaces as unknown labels in the UI (reported in #439).

Changes

  • Move triggers from YAML frontmatter into a markdown body section in SKILL.md
  • Flatten metadata to a string-to-string homepage entry in both SKILL.md and SKILL_en.md
  • Install/uninstall skills under ~/.config/opencode/skills alongside existing agent paths
  • Add regression tests for OpenCode-compatible frontmatter and OpenCode install path

Tests

  • pytest tests/test_skill_command.py -v — 7 passed
  • Full suite: 198 passed (composer-2.5 review run)

Notes

  • Trigger keywords remain available in the skill body and in description for all agents
  • OpenClaw macOS "Website" link metadata may use metadata.homepage instead of nested metadata.openclaw.homepage; skill loading/activation is unaffected

Fixes #439

Fixes Panniantong#439

OpenCode only recognizes name, description, license, compatibility, and
flat string metadata in SKILL.md frontmatter. The bundled skill used a
triggers field and nested metadata.openclaw.homepage, which surfaced as
'Unknown text label' warnings in the OpenCode UI.

- Move triggers from frontmatter into the markdown body
- Flatten metadata to a string-to-string homepage entry
- Install/uninstall skills under ~/.config/opencode/skills
- Add regression tests for OpenCode-compatible frontmatter
@Panniantong

Copy link
Copy Markdown
Owner

感谢定位 OpenCode frontmatter 兼容问题。merged #576 已同时提供兼容 metadata、OpenCode discovery 路径、安装与卸载支持及 wheel smoke,因此关闭此已取代实现。

@Panniantong Panniantong closed this Aug 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[BUG] Unknown text label when installed on Opencode | [06-27-2026]

2 participants