OpenCode Hotfix for BMAD Skills

[jheyworth]

Problem 1 — Broken paths

Skills use ./workflow.md — relative path fails under OpenCode.

Problem 2 — No direct invocation

Skills can only be reached via /skills menu. No /bmad-help, /bmad-quick-dev, etc.

Don't just drop the ./ — it still breaks

Changing ./workflow.md to workflow.md does not fix this. OpenCode still resolves it relatively and the skill still fails to find its workflow file. The only fix that works is a full path rooted at the project:

.opencode/skills/<folder>/workflow.md

Root fixes

• Templates must emit full path: .opencode/skills/<folder>/workflow.md
• Installer should generate .opencode/commands/<skill>.md per skill

Why this is an issue, not a PR

I understand the BMAD skills and installer are already being reworked, so I don't want to pre-empt that with a PR. This issue exists purely as a shareable workaround so affected users can repair their installs right now, before the rework lands.

Workaround

The attached prompt fixes both problems in a single run.

How to run

• Save: Download the below linked Hot Fix Prompt for BMAD Skills in OpenCode.md into your project root
  ( Hot Fix Prompt for BMAD Skills in OpenCode.md )

• Run: run Hot Fix Prompt for BMAD Skills in OpenCode.md

• Confirm: Review dry-run TUI, reply Yes

• Verify: Restart OpenCode, type /bmad-help

Safe

• Dry-run first
• Idempotent
• Preserves inline skills (no workflow.md sibling)
• Skips existing commands
• Any unrecognised pattern → reported as "needs manual review", never silently mangled

[coderabbitai]

⚠️ Possible Duplicate Issue(s)

• [BUG] opencode does not load any skills involving a workflow.md in the skill folder #1956

🔗 Related PRs

#1769 - fix(templates): replace @ path prefixes with {project-root} [merged]
#1892 - docs: drop slash-command prefix from skill references [merged]
#1983 - fix(skill): clean up bmad-create-ux-design validation findings [merged]
#1987 - fix(skill): clean up bmad-create-architecture validation findings [merged]
#2087 - fix(quick-dev): use absolute paths in code -r invocations [merged]

---

📝 Issue Planner

_{Check the box below or use the @coderabbitai plan command to generate an implementation plan and prompts that you can use with your favorite coding assistant.}

• Create Plan

---

🧪 Issue enrichment is currently in open beta.

You can configure auto-planning by selecting labels in the issue_enrichment configuration.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord!

[gtakodev]

Thank you very much, you helped fix the issue for me.

[bmadcode]

Closing — reporter confirmed fix in-thread ("helped fix the issue for me") via PR #1769.

[gtakodev]

Hello,

I'd like to chime in. The script the issuer made worked for me, but it doesn't solve the underlying problem: BMAD needs to properly implement skills for opencode.

[jheyworth]

Followup on the discoverability issue @gtakodev raised in above comment that was made after this GH issue was closed.

I have opened PR #2324.

What PR #2324 does:

• It generates .opencode/commands/<canonicalId>.md pointer files during install, so OpenCode users can invoke skills directly (e.g. /bmad-quick-dev, /bmad-create-prd, /bmad-help) instead of going through the /skills menu.

Scope:

• OpenCode-only, opt-in via a new commands_target_dir field
• Other IDEs supported by this installer are unaffected
• Symmetric cleanup on uninstall
• npm test green; OpenCode test suite extended

Happy to close if a parallel rework is already in flight.
cc: @bmadcode