fix-build

A procedure for diagnosing and fixing failed iOS or Android builds in React Native projects.

In plain words
What is it for?
Use it when CocoaPods, Gradle, Xcode, dependency installation, or another native build step fails.
Why use it?
It identifies the actual build error and applies a targeted fix instead of relying on repeated cache clearing or unrelated changes.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/anilburcu/claude-code-react-native/fix-build
Any agent
npx skills add AnilBurcu/claude-code-react-native --skill fix-build
Clone the repo
git clone --depth 1 https://github.com/AnilBurcu/claude-code-react-native

Made for: Claude Code, Codex.

Per session 42 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 472 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00042 $0.00472
Opus 5 $0.00021 $0.00236
Sonnet 5 $0.00008 $0.00094
Haiku 4.5 $0.00004 $0.00047

Measured 2d ago against content hash 29384f628af5, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

fix-build scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/rn/skills/fix-build/SKILL.md · 26 lines

What it actually says

Fix the failing native build. Work the problem, do not shotgun it.

  1. Identify the project shape first: Expo with CNG (no committed native folders, or folders marked generated), bare workflow, or plain React Native. Check for app.json/app.config.*, eas.json, and whether ios/ and android/ are committed.

  2. Reproduce the failure and capture the full log:

    • If the user provided a platform in $ARGUMENTS, build that one. Otherwise ask which platform failed, or build the one whose error the user pasted.
    • Expo projects: npx expo run:ios / npx expo run:android (or cd ios && pod install first when pods are the suspect)
    • Plain React Native without the expo package: npx react-native run-ios / npx react-native run-android
    • Pipe output to a file so nothing scrolls away.
  3. Find the FIRST real error in the log, not the last line. Android: deepest Caused by:. iOS: first error: line and the build step above it. Quote the exact error to the user in one line before fixing anything.

  4. Apply the native-build-errors skill's playbook for that error family. Choose the smallest fix that addresses the cause. Cache cleaning goes in the documented order, never as step one, and each destructive step gets stated before it runs.

  5. If the error names a third-party library, search its GitHub issues for the exact error string plus the React Native version before patching anything locally.

  6. Rebuild to verify. A fix without a green rebuild is a guess. If the rebuild surfaces a NEW first error, that is progress; repeat from step 3.

  7. Close with a short report: root cause, what changed, and whether the fix has release implications (a new native dependency or config change means the next release must be a store build, not an OTA update).

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 26 lines · 42 tokens per session scan A 29384f628af5

Subscribe to this mod's changes

fix-build is a skill published in the GitHub repository AnilBurcu/claude-code-react-native (3 stars, last pushed 1mo ago), licensed MIT. It adds 42 tokens to every session and 472 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

uniwind

Uniwind — Tailwind CSS v4 styling for React Native. Use when adding, building, or debugging components in a React Native project that uses Uniwind classNames. Covers setup, Metro config, global.css, theming, className props, accent- color props, platform/data/state/responsive variants, CSS variables, custom utilities…

uni-stack/uniwind · 130 tokens

setup-react-native-storybook

Set up Storybook for React Native in Expo, React Native CLI, or Re.Pack projects. Use when adding Storybook to a project, configuring metro.config.js with withStorybook, creating .rnstorybook configuration files, setting up Storybook routes in Expo Router, configuring getStorybookUI, or adding the StorybookPlugin to a…

storybookjs/react-native · 102 tokens

upgrading-react-native-storybook

Incrementally upgrade React Native Storybook across the supported migration paths. Use when upgrading @storybook/react-native projects from 5.3.x to 6.5.x, 6.5.x to 7.6.x, 7.6.x to 8.3.x, 8.x to 9.x, or 9.x to 10.x. Detect the currently installed Storybook version, choose only the next migration step, update…

storybookjs/react-native · 151 tokens

migrate-nativewind-to-uniwind

Migrate a React Native project from NativeWind to Uniwind. Use when the user wants to replace NativeWind with Uniwind, upgrade from NativeWind, switch to Uniwind, or mentions NativeWind-to-Uniwind migration. Handles package removal, config migration, Tailwind 4 upgrade, cssInterop removal, theme conversion, and all…

uni-stack/uniwind · 82 tokens

unistyles-v2-to-v3-migration

Migrate react-native-unistyles from v2 to v3. Triggers on: "migrate unistyles", "upgrade unistyles", "v2 to v3", "unistyles migration", "update unistyles", "convert unistyles v2". Covers all API changes including StyleSheet.create, useStyles removal, theme configuration, variants, withUnistyles, Babel plugin setup…

jpudysz/react-native-unistyles · 104 tokens

react-native-unistyles-v3

Guide for using react-native-unistyles v3. Triggers on: "unistyles", "StyleSheet.create", "create stylesheet", "add theme", "breakpoints", "variants", "withUnistyles", "useUnistyles", "ScopedTheme", "UnistylesRuntime", "style component", "responsive styles", "media queries", "dynamic styles", "scoped theme", "adaptive…

jpudysz/react-native-unistyles · 125 tokens