skills.rest
sanjanb
sanjanbCOMMUNITY
Explore all skills by this author →
GitHub

ios-clean

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

1|Updated Jul 23, 2026
Search Tags:#swift#ios#instrumentation#ci#spm#release build#debug cleanup
One-click install
npx skills add https://github.com/sanjanb/my-agent-harness --skill ios-clean-sanjanb
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ios-clean
Source: https://github.com/sanjanb/my-agent-harness/tree/main/skills/gstack-ios-clean
Command: npx skills add https://github.com/sanjanb/my-agent-harness --skill ios-clean-sanjanb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After running iOS QA instrumentation, your app is left with a DebugBridge Swift package, #if DEBUG blocks, StateServer, DebugOverlay, and generated accessor code that must be stripped before shipping. This Skill automates that cleanup so debug instrumentation never leaks into a release build. ## Core Features & Use Cases - DebugBridge Removal: Deletes the DebugBridge SPM package and all app-side hooks installed by the /ios-qa workflow. - Debug Wiring Cleanup: Strips #if DEBUG blocks, StateServer, DebugOverlay, and accessor codegen output from the iOS codebase. - Release Safety Guard: Relies on a structural Release-build guard (Package.swift conditional plus a CI swift build -c release check) as the safety-critical verification path. - Use Case: After finishing a QA pass on your iOS app, ask the agent to clean the debug bridge so the repository is back to a shippable state with release builds verified in CI. ## Quick Start Ask the agent to clean the iOS debug bridge and remove all DebugBridge instrumentation from this project.

Frequently Asked Questions about ios-clean

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

FAQPage Schema
How do I remove debug instrumentation from an iOS app before release?▼

Invoke this skill to remove the DebugBridge SPM package, #if DEBUG blocks, StateServer, DebugOverlay, and generated accessor code. It cleans everything the ios-qa workflow installed and relies on a release build check to confirm safety.

What is the DebugBridge SPM package used for?▼

DebugBridge is a Swift package installed by the ios-qa skill to expose app state for QA automation, including a StateServer and DebugOverlay. It is debug-only tooling and should be stripped before shipping a release build.

Does this skill guarantee debug code never reaches release builds?▼

The skill itself is a convenience wrapper for cleanup. The safety-critical path is structural: a Package.swift conditional plus a CI `swift build -c release` check that fails if debug wiring leaks into release configuration.

Can I use this skill without having run ios-qa first?▼

It is designed specifically to undo instrumentation installed by the ios-qa workflow, including its codegen output and app-side hooks. If your project never had DebugBridge installed, there is nothing for it to clean.

What triggers this skill in an AI agent session?▼

Phrases like "clean the iOS debug bridge", "remove DebugBridge", or "strip the gstack iOS instrumentation" activate it. These also work as voice triggers through speech-to-text input.

Related Skills

Explore More Software Engineering Skills→
abdulazeezojabdulazeezoj

ios-clean

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

Community
Intermediate
sadie100sadie100

ios-clean

Remove DebugBridge SPM package and #if DEBUG wiring from iOS apps.

Community
Advanced
abrahamgreysonabrahamgreyson

ios-clean

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

Community
Advanced
SakshamKandelSakshamKandel

ios-clean

Remove the DebugBridge SPM package and #if DEBUG blocks from iOS projects.

Community
Intermediate