skills.rest
raghavbadhwar
raghavbadhwarCOMMUNITY
Explore all skills by this author →
GitHub

ios-clean

Removes the DebugBridge SPM package and DEBUG wiring from an iOS app.

Updated Aug 9, 2026
Search Tags:#debug#cleanup#swift#ios#instrumentation#spm#release build
One-click install
npx skills add https://github.com/raghavbadhwar/rstack --skill ios-clean-raghavbadhwar
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ios-clean
Source: https://github.com/raghavbadhwar/rstack/tree/main/ios-clean
Command: npx skills add https://github.com/raghavbadhwar/rstack --skill ios-clean-raghavbadhwar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After debugging an iOS app with the gstack DebugBridge instrumentation, leftover debug code (StateServer, DebugOverlay, generated accessors, and #if DEBUG hooks) must be stripped before shipping. This Skill automates that cleanup so no debug instrumentation leaks into release builds. ## Core Features & Use Cases - DebugBridge removal: Uninstalls the DebugBridge Swift Package Manager dependency and all app-side hooks installed by /ios-qa. - Instrumentation cleanup: Removes StateServer, DebugOverlay, and accessor codegen output wired behind #if DEBUG flags. - Release safety: Works alongside the structural Release-build guard (Package.swift conditional plus CI swift build -c release check) that blocks debug code from shipping. - Use Case: After finishing a live-device QA session, ask the agent to strip the debug instrumentation so the codebase is clean for the release branch. ## Quick Start Ask the agent to clean the iOS debug bridge and remove all DebugBridge instrumentation from the 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?▼

Invoke the ios-clean skill, which uninstalls the DebugBridge SPM package and removes all app-side hooks installed by /ios-qa. It also cleans up StateServer, DebugOverlay, and generated accessor code behind #if DEBUG flags.

How to strip debug instrumentation before an iOS release build?▼

Run the cleanup skill to remove the debug bridge package and #if DEBUG wiring, then rely on the structural guard: a Package.swift conditional plus a CI swift build -c release check that fails if debug code remains.

Does ios-clean affect release builds of my Swift package?▼

No. The skill only removes debug-only instrumentation, and the safety-critical path is the Release-build guard that compiles with swift build -c release in CI. DebugBridge is conditionally excluded from release configurations.

What is the difference between ios-clean and ios-qa?▼

ios-qa installs the DebugBridge instrumentation for live-device testing, while ios-clean is the reverse convenience wrapper that removes StateServer, DebugOverlay, codegen output, and app-side hooks after QA is done.

When should I not run iOS debug bridge cleanup?▼

Skip cleanup while you are still actively debugging with live-device QA, since removing DebugBridge deletes the StateServer and overlay the QA workflow depends on. Run it only when instrumentation is no longer needed.

Related Skills

Explore More Software Engineering Skills→
sanjanbsanjanb
1

ios-clean

Removes the DebugBridge SPM package and debug wiring from iOS apps.

Community
Advanced
mi179mi179
1

ios-clean

Remove DebugBridge instrumentation and related wiring from iOS apps.

Community
Advanced
abrahamgreysonabrahamgreyson

ios-clean

Remove DebugBridge package and debug-only wiring from iOS Swift projects.

Community
Advanced
abdulazeezojabdulazeezoj

ios-clean

Remove the DebugBridge SPM package and all #if DEBUG wiring from an iOS app.

Community
Intermediate