ios-clean

Remove DebugBridge SPM package and debug configurations from iOS apps.

127k|19.1k|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/garrytan/gstack --skill ios-clean-garrytan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ios-clean
Source: https://github.com/garrytan/gstack/tree/main/ios-clean
Command: npx skills add https://github.com/garrytan/gstack --skill ios-clean-garrytan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps in removing the DebugBridge SPM package and all #if DEBUG wiring from an iOS app, streamlining the app for production release.

Core Features & Use Cases

  • Removes DebugBridge: Cleans up StateServer, DebugOverlay, accessor codegen output, and app-side hooks installed by /ios-qa.
  • Pre-production Readiness: Ensures that the app is free of debug-related artifacts, making it ready for a release.
  • Use Case: When preparing an iOS app for release, this Skill can be used to remove all debug configurations, ensuring a clean and optimized production build.

Quick Start

Run the ios-clean skill to strip the gstack iOS instrumentation from your app.

Frequently Asked Questions about ios-clean

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I remove DebugBridge from an iOS app before release?

To remove DebugBridge from an iOS app before release, this Skill strips the SPM package, StateServer, DebugOverlay, and app-side hooks installed by ios-qa. It reads and edits code while executing Bash scripts to ensure a clean production build.

What is the best way to clean debug configurations from an iOS project?

Cleaning debug configurations from an iOS project is done by removing all #if DEBUG wiring and accessor codegen output. This Skill uses Glob and Grep for pattern matching to locate and strip debug artifacts, streamlining the app for release.

Why does my iOS app build still include DebugOverlay in production?

Your iOS app build includes DebugOverlay in production because the DebugBridge SPM package and debug configurations were not removed. Running this Skill cleans up StateServer, accessor codegen output, and app-side hooks to ensure pre-production readiness.

Can I use Bash scripts to automate iOS code cleanup for pre-production checks?

Yes, you can use Bash scripts to automate iOS code cleanup for pre-production checks. This Skill executes Bash scripts to remove the DebugBridge SPM package and debug configurations, reading and editing code as necessary using pattern matching.

What debug artifacts should be removed from an iOS app for a release?

Debug artifacts that should be removed from an iOS app for a release include the DebugBridge SPM package, StateServer, DebugOverlay, accessor codegen output, and all #if DEBUG wiring. This Skill ensures the app is free of these debug-related artifacts.

Does ios-clean work with Swift Package Manager dependencies?

Yes, ios-clean works with Swift Package Manager dependencies by specifically targeting and removing the DebugBridge SPM package. It cleans up associated StateServer and DebugOverlay components, ensuring the iOS app is optimized for production release.