OpenCode reads skills from a project-local .opencode/skills folder. Add the FlowDeck skill there.
What the Skill Does
The FlowDeck skill teaches the agent to use FlowDeck for iOS/macOS build, run, test, and debug workflows instead of Apple CLI tools. It also standardizes project discovery and simulator management so the agent can operate with fewer retries.
Skills provide guidance, but they do not prevent the agent from sidetracking to xcodebuild or simctl.
Reinforce in AGENTS.md
OpenCode does not support hooks to prevent it from using Apple tools, so for better performance, it’s recommended to include the following in your AGENTS.md file to instruct it to prefer the FlowDeck skill:
Use the FlowDeck skill and CLI for all iOS/macOS build, run, test, and debug tasks.
Do not use xcodebuild, xcrun simctl, or other Apple CLI tools unless FlowDeck is unavailable.
If a FlowDeck command fails, troubleshoot using FlowDeck output and retry before falling back.
Project vs System Skill
Project Skill (Shared with the Repo)
mkdir -p .opencode/skills/flowdeck
curl -sSL https://raw.githubusercontent.com/flowdeck-studio/flowdeck-plugin/main/skills/flowdeck/SKILL.md -o .opencode/skills/flowdeck/SKILL.md
System Skill (Applies to All Projects)
mkdir -p ~/.config/opencode/skills/flowdeck
curl -sSL https://raw.githubusercontent.com/flowdeck-studio/flowdeck-plugin/main/skills/flowdeck/SKILL.md -o ~/.config/opencode/skills/flowdeck/SKILL.md
OpenCode also reads Claude-compatible skills from ~/.claude/skills if you already use that directory.
Example Prompts
"Build and run my app on an iPhone 16 simulator"
"Run the unit tests and fix any failures"
"Take a screenshot of the current simulator state"
"Run the app and check logs to understand why the login screen isn't working"
