This skill should be used when the user asks to "setup CI/CD pipeline", "configure Fastlane", "automate TestFlight deployment", "setup build schemes", "configure code signing", "create GitHub Actions workflow", or needs guidance on iOS build automation and continuous deployment.
From ios-dev-toolkitnpx claudepluginhub nbkm8y5/claude-plugins --plugin ios-dev-toolkitThis skill uses the workspace's default tool permissions.
references/build-configurations.mdreferences/cicd-workflows.mdreferences/fastlane-reference.mdscripts/create_feature_flags.pyscripts/create_github_workflow.pyscripts/generate_fastlane_config.pyscripts/setup_build_schemes.pyscripts/setup_crashlytics.pySearches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.
Guides implementation of event-driven hooks in Claude Code plugins using prompt-based validation and bash commands for PreToolUse, Stop, and session events.
Comprehensive iOS build automation and CI/CD pipeline setup that integrates all quality checks, testing, and deployment into a seamless automated workflow.
Use this skill when:
Build Configuration Management
Code Signing Automation
CI/CD Pipeline Creation
Fastlane Configuration
Crash Reporting Setup
Feature Flag Infrastructure
Generate complete build configuration setup with Debug, Staging, and Release environments.
Usage:
python setup_build_schemes.py com.example.app [project-directory]
Output:
.xcconfig files for each configurationEnvironment.swift for runtime accessExample:
python setup_build_schemes.py com.mortgage.calculator .
Generate comprehensive Fastlane configuration with lanes for testing, building, and deployment.
Usage:
python generate_fastlane_config.py <app-id> <apple-id> <team-id> <itc-team-id> [certs-repo]
Output:
Fastfile with complete lane definitionsAppfile with app credentialsMatchfile for code signingGymfile and Scanfile for build/test configExample:
python generate_fastlane_config.py \\
com.mortgage.calculator \\
dev@example.com \\
ABC123 \\
12345 \\
https://github.com/org/certs.git
Generated Lanes:
fastlane test - Run all tests with coveragefastlane quality - Run all quality checks (integrates existing skills)fastlane beta - Build and deploy to TestFlightfastlane release - Submit to App Storefastlane certificates - Sync code signingGenerate GitHub Actions workflows for complete CI/CD automation.
Usage:
python create_github_workflow.py <workflow-type>
Workflow Types:
ci - Complete CI workflow with quality checks and teststestflight - TestFlight deployment workflowrelease - App Store release workflowall - Generate all workflowsOutput:
.github/workflows/ci.yml - Main CI pipeline.github/workflows/testflight.yml - TestFlight deployment.github/workflows/release.yml - App Store submissionExample:
python create_github_workflow.py all
Key Features:
Generate Firebase Crashlytics integration code and configuration.
Usage:
python setup_crashlytics.py
Output:
CrashlyticsManager.swift - Complete crash reporting managerAppDelegate-Integration.swift - App integration codeupload-symbols-build-phase.sh - Xcode build phase scriptPodfile-snippet.rb - CocoaPods dependenciesFeatures:
Generate complete feature flag infrastructure with local and remote config support.
Usage:
python create_feature_flags.py
Output:
FeatureFlagManager.swift - Feature flag managerFeatureFlags-Usage-Examples.swift - Integration examplesFeatures:
Complete guide to iOS build configurations:
.xcconfig file managementWhen to read: Setting up or modifying build configurations, understanding environment management, troubleshooting build settings.
Comprehensive CI/CD pipeline examples:
When to read: Creating new CI/CD pipelines, optimizing existing workflows, adding quality gates, setting up deployment automation.
Complete Fastlane reference:
When to read: Writing or debugging Fastlane lanes, understanding Fastlane actions, configuring code signing with Match.
This skill is designed to automate all your existing iOS skills in a CI/CD pipeline:
lane :audit_quality do
sh("python3 ../ios-code-quality-auditor/scripts/audit_code.py .")
end
CI Integration:
- name: Run Code Quality Audit
run: python3 ios-code-quality-auditor/scripts/audit_code.py .
lane :audit_architecture do
sh("python3 ../swiftui-architecture-review/scripts/analyze_architecture.py .")
end
CI Integration:
- name: Architecture Review
run: python3 swiftui-architecture-review/scripts/analyze_architecture.py .
lane :test do
run_tests(
scheme: "MortgageCalculator",
code_coverage: true
)
end
CI Integration:
- name: Run Tests
run: xcodebuild test -scheme MortgageCalculator -enableCodeCoverage YES
lane :validate_submission do
sh("python3 ../app-store-submission/scripts/validate_submission.py .")
end
CI Integration:
- name: App Store Validation
run: python3 app-store-submission/scripts/validate_submission.py .
- name: Verify PDF Export
run: |
xcodebuild test \\
-scheme MortgageCalculator \\
-testPlan PDFExportTests
python scripts/setup_build_schemes.py com.mortgage.calculator .
python scripts/generate_fastlane_config.py \\
com.mortgage.calculator \\
dev@example.com \\
ABC123DEF4 \\
12345
python scripts/create_github_workflow.py all
python scripts/setup_crashlytics.py
python scripts/create_feature_flags.py
Developer pushes code
↓
GitHub Actions triggers
↓
Quality Checks (parallel):
• iOS Code Quality Auditor ✓
• SwiftUI Architecture Review ✓
• SwiftLint ✓
↓
Tests (parallel):
• Unit Tests ✓
• UI Tests ✓
• Coverage Check (80%+) ✓
↓
Build:
• Debug (develop branch)
• Release (main branch)
↓
Validation:
• App Store Pre-flight ✓
• PDF Export Verification ✓
↓
Deploy (conditional):
• TestFlight (main branch)
• App Store (tagged release)
↓
Monitor:
• Crashlytics tracking
• Feature flag management
↓
Notify Team (Slack/Email)
After setup, deployment becomes simple:
# Deploy to TestFlight
fastlane beta
# Release to App Store
fastlane release
# Run all quality checks
fastlane quality
# Test everything
fastlane test
Maintain distinct configurations for each environment with unique bundle IDs:
com.example.app.debug (Debug)com.example.app.staging (Staging)com.example.app (Release)This allows installing multiple builds simultaneously for testing.
Use Fastlane Match to manage certificates and profiles in a git repository:
Fail builds early on quality issues:
Always increment build numbers automatically:
increment_build_number(
build_number: latest_testflight_build_number + 1
)
Use feature flags to:
Integrate Crashlytics from day one:
Maintain a CI/CD documentation file:
Required secrets for GitHub Actions:
# Code Signing
MATCH_PASSWORD # Password for certificates repo
MATCH_GIT_BASIC_AUTHORIZATION # Git access token
# Apple Developer
APPLE_ID # Apple ID email
APPLE_ID_PASSWORD # Apple ID password
APP_SPECIFIC_PASSWORD # App-specific password
# Notifications (optional)
SLACK_WEBHOOK # Slack webhook URL
Set these in: Repository Settings → Secrets and variables → Actions
Issue: Code signing errors
# Reset Match certificates
fastlane match appstore --force
Issue: Tests failing in CI but passing locally
# Check simulator availability
xcrun simctl list devices
# Clean derived data
rm -rf ~/Library/Developer/Xcode/DerivedData
Issue: Wrong configuration being built
# Verify scheme configuration
xcodebuild -list -project MortgageCalculator.xcodeproj
Issue: TestFlight upload timeout
# Increase timeout in Fastfile
upload_to_testflight(
skip_waiting_for_build_processing: true
)
Issue: App Store Connect authentication
# Verify credentials
fastlane spaceauth -u dev@example.com
setup_build_schemes.py to create configurationsgenerate_fastlane_config.py to setup Fastlanecreate_github_workflow.py all for CI/CDfastlane testfastlane betasetup_crashlytics.pycreate_feature_flags.pyBefore automation:
After automation:
fastlane betaTime savings: ~2 hours per week Quality improvement: 100% consistent quality checks Deployment confidence: Every release fully validated