For AI coding assistants like Windsurf, Cline, Copilot, or others, you can add the skill as a reference in AGENTS.md.
The Claude Code plugin includes a hook that actively blocks attempts to use xcodebuild/simctl, ensuring the agent always uses FlowDeck. Other agents receive the skill instructions but may occasionally fall back to Apple’s tools.
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.
Project vs System Skill
Project Skill (Recommended)
Download the skill and reference it from your repo rules file.
curl -sSL https://raw.githubusercontent.com/flowdeck-studio/flowdeck-plugin/main/skills/flowdeck/SKILL.md -o FLOWDECK.md
System Skill (If Your Agent Supports Global Rules)
If your agent supports user-level rules, add the same import to its global rules file so the skill applies to all projects. The file name and location vary by agent.
These agents do not support hooks to prevent them from using Apple tools, so for better performance, it’s recommended to include the following in your AGENTS.md file to instruct them 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.
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"
