objc-gnustep-regression-audit

Audit Objective-C code for GNUstep and Linux portability regressions.

Updated Jul 26, 2026
One-click install
npx skills add https://github.com/jvalinsky/garazyk --skill objc-gnustep-regression-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: objc-gnustep-regression-audit
Source: https://github.com/jvalinsky/garazyk/tree/main/skills/objc-gnustep-regression-audit
Command: npx skills add https://github.com/jvalinsky/garazyk --skill objc-gnustep-regression-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps developers identify and fix Objective-C code that may cause regressions when running on GNUstep or Linux, preventing build failures and runtime issues on non-macOS platforms.

Core Features & Use Cases

  • Platform-Specific API Detection: Flags the use of macOS-only APIs that lack proper guards.
  • Import Analysis: Identifies imports that might not be available or behave differently on GNUstep.
  • Guard Clause Verification: Checks for the presence of TARGET_OS_LINUX or similar guards around platform-sensitive code.
  • Use Case: When a developer merges a feature that uses new macOS frameworks, this Skill can automatically scan the changes to ensure that the code is either guarded or uses compatible alternatives, preventing a Linux build from breaking.

Quick Start

Run the gnustep regression audit script on the current directory and output results to /tmp/objc-gnustep-regression-audit.

Frequently Asked Questions about objc-gnustep-regression-audit

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

FAQPage Schema
How do I find macOS-only API usage causing GNUstep Linux build breakages?

To find macOS-only API usage causing GNUstep build breakages, audit Objective-C source files to identify unguarded platform-specific calls, missing TARGET_OS_LINUX guards, and compat-layer bypasses in your cross-platform changes.

What is a GNUstep portability regression in Objective-C?

A GNUstep portability regression occurs when Objective-C code introduces macOS-only frameworks or bypasses compatibility layers without proper platform guards, leading to Linux build failures and runtime issues on non-macOS platforms.

How do I check for missing TARGET_OS_LINUX guards in Objective-C source files?

Check for missing TARGET_OS_LINUX guards by running a regression audit script that scans Objective-C and Objective-C++ source files for platform-sensitive code lacking proper conditional compilation boundaries.

Does the Objective-C GNUstep regression audit require any specific tools?

Yes, the Objective-C GNUstep regression audit requires the 'rg' command-line tool to be installed in your environment to scan source files and detect portability issues.

Can I scan Objective-C++ files for GNUstep compatibility issues?

Yes, you can scan Objective-C++ files for GNUstep compatibility issues because the audit analyzes both Objective-C and Objective-C++ source files to detect missing platform guards and macOS-only imports.

Why does my Objective-C Linux build fail after merging macOS framework changes?

Your Objective-C Linux build fails because merged macOS framework changes likely lack TARGET_OS_LINUX guards or bypass compat-layers, requiring an audit to identify and wrap platform-specific API usage.