fix: use bare path workflow references in SKILL.md for Opencode compatibility

sjennings · claude · sjennings · commit 6223d6419cef · 2026-04-01T15:13:03.000-05:00
Opencode does not follow markdown-style links when resolving skill
workflow files. Changed all 28 workflow SKILL.md files from
`[workflow.md](workflow.md)` to `./workflow.md` to match BMAD-METHOD.

Co-Authored-By: Claude Opus 4.6 (1M context) &lt;noreply@anthropic.com&gt;
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,11 @@
 # CHANGELOG
 
+## v0.2.3 - Apr 1, 2026
+
+### Opencode Compatibility Fix
+
+* Changed SKILL.md workflow references from markdown links (`[workflow.md](workflow.md)`) to bare paths (`./workflow.md`) across all 28 workflow skills, matching the BMAD-METHOD convention. Opencode does not follow markdown-style links when resolving skill workflow files.
+
 ## v0.2.2 - Mar 16, 2026
 
 ### Agent Skill Conversion
diff --git a/package.json b/package.json
@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "bmad-game-dev-studio",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "private": true,
   "description": "A BMad MEthod Core Module that offers a substantial stand alone module for Game Development across multiple supported platforms",
   "keywords": [
diff --git a/src/workflows/1-preproduction/gds-brainstorm-game/SKILL.md b/src/workflows/1-preproduction/gds-brainstorm-game/SKILL.md
@@ -3,4 +3,4 @@ name: gds-brainstorm-game
 description: 'Facilitate game brainstorming sessions with game-specific techniques. Use when the user says "brainstorm game" or "game ideas"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/1-preproduction/gds-create-game-brief/SKILL.md b/src/workflows/1-preproduction/gds-create-game-brief/SKILL.md
@@ -3,4 +3,4 @@ name: gds-create-game-brief
 description: 'Interactive game brief creation guiding users through defining their game vision. Use when the user says "game brief" or "create brief"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/1-preproduction/research/gds-domain-research/SKILL.md b/src/workflows/1-preproduction/research/gds-domain-research/SKILL.md
@@ -3,4 +3,4 @@ name: gds-domain-research
 description: 'Conduct game domain and industry research. Use when the user says "lets create a research report on [game domain or industry]"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/2-design/gds-create-gdd/SKILL.md b/src/workflows/2-design/gds-create-gdd/SKILL.md
@@ -3,4 +3,4 @@ name: gds-create-gdd
 description: 'Create Game Design Documents with mechanics and implementation guidance. Use when the user says "create GDD" or "game design document"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/2-design/gds-create-narrative/SKILL.md b/src/workflows/2-design/gds-create-narrative/SKILL.md
@@ -3,4 +3,4 @@ name: gds-create-narrative
 description: 'Create comprehensive narrative documentation with story structure and world-building. Use when the user says "narrative design" or "create narrative"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/2-design/gds-create-ux-design/SKILL.md b/src/workflows/2-design/gds-create-ux-design/SKILL.md
@@ -3,4 +3,4 @@ name: gds-create-ux-design
 description: 'Plan UX patterns and design specifications for game UI/HUD elements. Use when the user says "lets create UX design" or "create UX specifications" or "help me plan the game UX"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/3-technical/gds-check-implementation-readiness/SKILL.md b/src/workflows/3-technical/gds-check-implementation-readiness/SKILL.md
@@ -3,4 +3,4 @@ name: gds-check-implementation-readiness
 description: 'Verify GDD, UX, Architecture, and Epics alignment before production. Use when the user says "check readiness" or "implementation readiness"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/3-technical/gds-create-epics-and-stories/SKILL.md b/src/workflows/3-technical/gds-create-epics-and-stories/SKILL.md
@@ -3,4 +3,4 @@ name: gds-create-epics-and-stories
 description: 'Create Epics and Stories from GDD requirements for development. Use when the user says "create epics" or "create stories"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/3-technical/gds-game-architecture/SKILL.md b/src/workflows/3-technical/gds-game-architecture/SKILL.md
@@ -3,4 +3,4 @@ name: gds-game-architecture
 description: 'Design scale-adaptive game architecture with engine systems and networking. Use when the user says "game architecture" or "design architecture"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/3-technical/gds-generate-project-context/SKILL.md b/src/workflows/3-technical/gds-generate-project-context/SKILL.md
@@ -3,4 +3,4 @@ name: gds-generate-project-context
 description: 'Create optimized project-context.md for AI agent consistency. Use when the user says "project context" or "generate context"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/4-production/gds-code-review/SKILL.md b/src/workflows/4-production/gds-code-review/SKILL.md
@@ -3,4 +3,4 @@ name: gds-code-review
 description: 'Perform thorough code review to find bugs and quality issues. Use when the user says "review this code" or "do a code review"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/4-production/gds-correct-course/SKILL.md b/src/workflows/4-production/gds-correct-course/SKILL.md
@@ -3,4 +3,4 @@ name: gds-correct-course
 description: 'Manage significant changes when sprint implementation is off track. Use when the user says "correct course" or "we need a course correction"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/4-production/gds-create-story/SKILL.md b/src/workflows/4-production/gds-create-story/SKILL.md
@@ -3,4 +3,4 @@ name: gds-create-story
 description: 'Creates a dedicated story file with all the context the agent will need to implement it later. Use when the user says "create the next story" or "create story [story identifier]"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/4-production/gds-dev-story/SKILL.md b/src/workflows/4-production/gds-dev-story/SKILL.md
@@ -3,4 +3,4 @@ name: gds-dev-story
 description: 'Execute story implementation following a context filled story spec file. Use when the user says "dev this story [story file]" or "implement the next story in the sprint plan"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/4-production/gds-retrospective/SKILL.md b/src/workflows/4-production/gds-retrospective/SKILL.md
@@ -3,4 +3,4 @@ name: gds-retrospective
 description: 'Facilitate a retrospective after completing a game development epic. Use when the user says "run a retrospective" or "lets do a retro"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/4-production/gds-sprint-planning/SKILL.md b/src/workflows/4-production/gds-sprint-planning/SKILL.md
@@ -3,4 +3,4 @@ name: gds-sprint-planning
 description: 'Generate or update sprint status from epic files for sprint planning. Use when the user says "plan the sprint" or "create sprint plan"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/4-production/gds-sprint-status/SKILL.md b/src/workflows/4-production/gds-sprint-status/SKILL.md
@@ -3,4 +3,4 @@ name: gds-sprint-status
 description: 'Summarize current sprint progress and surface risks. Use when the user says "sprint status" or "how is the sprint going"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/gametest/gds-e2e-scaffold/SKILL.md b/src/workflows/gametest/gds-e2e-scaffold/SKILL.md
@@ -3,4 +3,4 @@ name: gds-e2e-scaffold
 description: 'Scaffold end-to-end testing infrastructure. Use when the user says "e2e scaffold" or "set up e2e testing"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/gametest/gds-performance-test/SKILL.md b/src/workflows/gametest/gds-performance-test/SKILL.md
@@ -3,4 +3,4 @@ name: gds-performance-test
 description: 'Design game performance testing strategy. Use when the user says "performance test" or "benchmark"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/gametest/gds-playtest-plan/SKILL.md b/src/workflows/gametest/gds-playtest-plan/SKILL.md
@@ -3,4 +3,4 @@ name: gds-playtest-plan
 description: 'Create structured playtesting plans for user feedback. Use when the user says "playtest plan" or "playtesting"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/gametest/gds-test-automate/SKILL.md b/src/workflows/gametest/gds-test-automate/SKILL.md
@@ -3,4 +3,4 @@ name: gds-test-automate
 description: 'Generate automated game tests for gameplay systems. Use when the user says "automate tests" or "generate tests"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/gametest/gds-test-design/SKILL.md b/src/workflows/gametest/gds-test-design/SKILL.md
@@ -3,4 +3,4 @@ name: gds-test-design
 description: 'Create comprehensive game test scenarios. Use when the user says "test design" or "design tests"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/gametest/gds-test-framework/SKILL.md b/src/workflows/gametest/gds-test-framework/SKILL.md
@@ -3,4 +3,4 @@ name: gds-test-framework
 description: 'Initialize game test framework for Unity, Unreal, or Godot. Use when the user says "test framework" or "set up testing"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/gametest/gds-test-review/SKILL.md b/src/workflows/gametest/gds-test-review/SKILL.md
@@ -3,4 +3,4 @@ name: gds-test-review
 description: 'Review test quality and coverage. Use when the user says "test review" or "review tests"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/gds-document-project/SKILL.md b/src/workflows/gds-document-project/SKILL.md
@@ -3,4 +3,4 @@ name: gds-document-project
 description: 'Analyze existing game projects to produce useful documentation. Use when the user says "document project" or "generate docs"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/gds-quick-flow/gds-quick-dev-new-preview/SKILL.md b/src/workflows/gds-quick-flow/gds-quick-dev-new-preview/SKILL.md
@@ -3,4 +3,4 @@ name: gds-quick-dev-new-preview
 description: 'Implements any user intent, GDD requirement, story, bug fix or change request by producing clean working code artifacts that follow the project''s existing game architecture, patterns and conventions. Use when the user wants to build, fix, tweak, refactor, add or modify any game code, component or feature.'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/gds-quick-flow/gds-quick-dev/SKILL.md b/src/workflows/gds-quick-flow/gds-quick-dev/SKILL.md
@@ -3,4 +3,4 @@ name: gds-quick-dev
 description: 'Flexible development workflow - execute tech-specs OR direct instructions with optional planning. Use when the user says "lets implement this feature" or "execute these development tasks"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.
diff --git a/src/workflows/gds-quick-flow/gds-quick-spec/SKILL.md b/src/workflows/gds-quick-flow/gds-quick-spec/SKILL.md
@@ -3,4 +3,4 @@ name: gds-quick-spec
 description: 'Create technical specs with implementation-ready stories. Use when the user says "quick spec" or "tech spec"'
 ---
 
-Follow the instructions in [workflow.md](workflow.md).
+Follow the instructions in ./workflow.md.

Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"$schema": "https://json.schemastore.org/package.json",`
`3`	`3`	`"name": "bmad-game-dev-studio",`
`4`		`- "version": "0.2.2",`
	`4`	`+ "version": "0.2.3",`
`5`	`5`	`"private": true,`
`6`	`6`	`"description": "A BMad MEthod Core Module that offers a substantial stand alone module for Game Development across multiple supported platforms",`
`7`	`7`	`"keywords": [`