Index of every page on this site: llms.txt
All skills
firebase avatar

/ios-simulator-test-recording

@80e0bc6
by firebasefirebase/firebase-ios-sdk7k stars
1,833
Run it yourself

Skill to run xcodebuild tests on iOS Simulator while recording a video walkthrough, dynamically selecting the highest available OS and device. Most useful for running XCUITests.

  • 2 files
  • 9.8 KB
  • Updated 5 months ago
  • GitHub
Use this Skill: https://skilld.dev/gh/firebase/firebase-ios-sdk/ios-simulator-test-recording

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈52 tokens for metadata: the name and description. ≈815 when used: this file.

Description uses 2.6% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈208 characters, or 2.6%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

iOS Simulator Test Recording Skill

This skill provides a generalized bash script to test run and record iOS Simulator workflows and UI tests. It handles everything natively through AWK TTY streams to ensure the camera triggers exactly when the app launches — eliminating the simulator's booting and install sequence.

The Script: run_test_and_record.sh

The core logic of this skill resides in ./.agents/skills/ios-simulator-test-recording/scripts/run_test_and_record.sh. You can call this script whenever you need to execute a test block accompanied by screen recording.

Usage

./.agents/skills/ios-simulator-test-recording/scripts/run_test_and_record.sh [OPTIONS] -- COMMAND
Options
  • --video PATH : Change the video output file. Default: simulator_test_walkthrough.mp4
  • --show-ui : Explicitly brings the Simulator.app window to the foreground so the user sees the execution happening. By default, it runs the simulator headless or in the background.
  • --udid UDID : Specifies the ID of the simulator to attach to. If left omitted, it queries xcrun simctl list devices available -j and auto-bootstraps the highest tier iPhone class.
Substituting the Device ID

If your test script requires injecting the target UDID dynamically, you can use the {UDID} placeholder inside your command execution block. The script will intercept and substitute it before launching.

Example Implementations

1. Basic Automated Fallback (Latest Simulator + Default Video)

  ./.agents/skills/ios-simulator-test-recording/scripts/run_test_and_record.sh \
  -- xcodebuild test -project SampleApp.xcodeproj -scheme SampleApp \
  -destination "platform=iOS Simulator,id={UDID}" -quiet

Note the usage of {UDID} to let the script automatically populate the chosen device ID.

2. Custom Video Path & Show UI

  ./.agents/skills/ios-simulator-test-recording/scripts/run_test_and_record.sh \
  --show-ui \
  --video "~/Code/firebase-ios-sdk/auth_test.mp4" \
  -- xcodebuild test -workspace App.xcworkspace -scheme AppUITests \
  -destination "platform=iOS Simulator,id={UDID}" -only-testing:AppUITests/testLogin -quiet

3. With a specific Custom UDID provided

  ./.agents/skills/ios-simulator-test-recording/scripts/run_test_and_record.sh \
  --udid "62425200-F824-4E55-ACB4-08D031165A82" \
  --video ./fast_test.mp4 \
  -- xcodebuild test -project Proj.xcodeproj ... -destination "platform=iOS Simulator,id={UDID}"

Important Maintenance Notes

If future framework changes cause the script to fail, take these notes into consideration:

  • Avoid using tail -F on XCTest logs inside CI arrays (it natively locks trailing descriptors indefinitely).
  • Avoid using "magic numbers" and sleep commands to time the simulator launch. The script uses a robust TTY-based stream hook that triggers exactly when the test runner starts, ensuring perfect synchronization without timing dependencies.
  • Avoid pipe xcodebuild into tee logs natively; block buffering will cache the entire script payload until test execution completion, causing the hook to deploy at the literal end of the tape, wiping your data. Always use the internal TTY script wrapper!

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at 80e0bc6. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 5 months ago

README badge

README badge for firebase/firebase-ios-sdk/ios-simulator-test-recording