Agent skill

Symbolication Setup

by nexus-labs-automation in nexus-labs-automation/mobile-observability

Configure crash symbolication for readable stack traces. An agent skill from nexus-labs-automation/mobile-observability.

MITAuto-check passedMobile

Install Symbolication Setup

skills CLI

$ npx skills add nexus-labs-automation/mobile-observability --skill symbolication-setup -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install nexus-labs-automation/mobile-observability symbolication-setup --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/nexus-labs-automation/mobile-observability.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/symbolication-setup .claude/skills/symbolication-setup && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "symbolication-setup" agent skill from https://github.com/nexus-labs-automation/mobile-observability/tree/main/skills/symbolication-setup into .claude/skills/symbolication-setup/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "symbolication-setup", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/nexus-labs-automation/mobile-observability/tree/main/skills/symbolication-setup

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add nexus-labs-automation/mobile-observability --skill symbolication-setup -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install nexus-labs-automation/mobile-observability symbolication-setup --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/nexus-labs-automation/mobile-observability.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/symbolication-setup .agents/skills/symbolication-setup && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "symbolication-setup" agent skill from https://github.com/nexus-labs-automation/mobile-observability/tree/main/skills/symbolication-setup into .agents/skills/symbolication-setup/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "symbolication-setup", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add nexus-labs-automation/mobile-observability --skill symbolication-setup -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install nexus-labs-automation/mobile-observability symbolication-setup --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/nexus-labs-automation/mobile-observability.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/symbolication-setup .cursor/skills/symbolication-setup && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "symbolication-setup" agent skill from https://github.com/nexus-labs-automation/mobile-observability/tree/main/skills/symbolication-setup into .cursor/skills/symbolication-setup/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "symbolication-setup", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/nexus-labs-automation/mobile-observability.git --path skills/symbolication-setup

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add nexus-labs-automation/mobile-observability --skill symbolication-setup -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install nexus-labs-automation/mobile-observability symbolication-setup --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/nexus-labs-automation/mobile-observability.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/symbolication-setup .gemini/skills/symbolication-setup && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "symbolication-setup" agent skill from https://github.com/nexus-labs-automation/mobile-observability/tree/main/skills/symbolication-setup into .gemini/skills/symbolication-setup/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "symbolication-setup", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install nexus-labs-automation/mobile-observability symbolication-setup

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add nexus-labs-automation/mobile-observability --skill symbolication-setup -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/nexus-labs-automation/mobile-observability.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/symbolication-setup .github/skills/symbolication-setup && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "symbolication-setup" agent skill from https://github.com/nexus-labs-automation/mobile-observability/tree/main/skills/symbolication-setup into .github/skills/symbolication-setup/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "symbolication-setup", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add nexus-labs-automation/mobile-observability --skill symbolication-setup -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install nexus-labs-automation/mobile-observability symbolication-setup --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/nexus-labs-automation/mobile-observability.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/symbolication-setup .opencode/skills/symbolication-setup && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "symbolication-setup" agent skill from https://github.com/nexus-labs-automation/mobile-observability/tree/main/skills/symbolication-setup into .opencode/skills/symbolication-setup/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "symbolication-setup", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: symbolication-setup
GitHub stars: 116
Token cost: ~996 tokens
SKILL.md length: 211 words
Files: 1
Skills in repo: 8
Repo updated: Aug 23, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Configure crash symbolication for readable stack traces. An agent skill from nexus-labs-automation/mobile-observability.

Setting up dSYMs (iOS)
SKILL.md covers Why It Matters, Platform Setup, Verification Checklist and Common Issues, plus 2 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
ProGuard/R8 mappings (Android)

What it does

Symbolication Setup is an agent skill from nexus-labs-automation/mobile-observability. Configure crash symbolication for readable stack traces. Use when setting up dSYMs (iOS), ProGuard/R8 mappings (Android), or source maps (React Native).

Its SKILL.md is about 1000 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile, covering Cross-platform mobile apps and Debugging. It works with React Native, Android, iOS and Gradle. The repository describes itself as: Claude Code plugin for mobile app observability: crash reporting, performance monitoring, and instrumentation for iOS, Android, and React Native. The licence is MIT.

When your agent uses it

Setting up dSYMs (iOS)
ProGuard/R8 mappings (Android)
Source maps (React Native)

Example prompts

“/symbolication-setup”

What it can do on your machine

Read from SKILL.md and the folder at commit 488c97f. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash, kotlin, proguard and json).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Symbolication Setup loads about 996 tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 211 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~43
When it runs · the whole SKILL.md, loaded when a task matches: ~996

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from nexus-labs-automation/mobile-observability at commit 488c97f, republished under its MIT licence (© nexus-labs-automation). 211 words, ~996 tokens.

Download SKILL.mdSave it as .claude/skills/symbolication-setup/SKILL.md (or your agent's skills folder).

name: symbolication-setup
description: Configure crash symbolication for readable stack traces. Use when setting up dSYMs (iOS), ProGuard/R8 mappings (Android), or source maps (React Native).
triggers: configure dSYMs, crash symbols, ProGuard mappings, readable stack traces, set up symbolication, source maps upload
priority: 1

Symbolication Setup

Make crash stack traces readable instead of memory addresses or minified code.

Why It Matters

Without symbolication:

0x104a3b2c8 <redacted> + 123

With symbolication:

PaymentViewController.processPayment() line 47

Unsymbolicated crashes are useless for debugging.

Platform Setup

iOS (dSYMs)

Xcode Build Phase Script:

bash

# Add to Build Phases → New Run Script Phase
if [ "${CONFIGURATION}" = "Release" ]; then
    # Sentry
    sentry-cli upload-dif --include-sources "${DWARF_DSYM_FOLDER_PATH}"

    # Or Crashlytics
    "${PODS_ROOT}/FirebaseCrashlytics/upload-symbols" \
        -gsp "${PROJECT_DIR}/GoogleService-Info.plist" \
        -p ios "${DWARF_DSYM_FOLDER_PATH}"
fi

Find missing dSYMs:

bash

# Recent archives
find ~/Library/Developer/Xcode/Archives -name "*.dSYM" -mtime -7

# Verify UUID matches
dwarfdump --uuid MyApp.app.dSYM

Android (ProGuard/R8)

build.gradle.kts:

kotlin

android {
    buildTypes {
        release {
            isMinifyEnabled = true
            proguardFiles(
                getDefaultProguardFile("proguard-android-optimize.txt"),
                "proguard-rules.pro"
            )
        }
    }
}

// Sentry auto-upload
sentry {
    autoUploadProguardMapping.set(true)
    uploadNativeSymbols.set(true)
}

// Or manual upload in CI
// sentry-cli upload-proguard --android-manifest app/build/.../AndroidManifest.xml mapping.txt

Keep rules for crash reporting:

proguard

# proguard-rules.pro
-keepattributes SourceFile,LineNumberTable
-renamesourcefileattribute SourceFile

# Keep Sentry classes
-keep class io.sentry.** { *; }

React Native (Source Maps)

Expo (app.json):

json

{
  "expo": {
    "plugins": [
      ["@sentry/react-native/expo", {
        "organization": "your-org",
        "project": "your-project"
      }]
    ],
    "hooks": {
      "postPublish": [{
        "file": "sentry-expo/upload-sourcemaps"
      }]
    }
  }
}

Bare React Native (CI):

bash

# After build
sentry-cli releases files $VERSION upload-sourcemaps \
    --dist $BUILD_NUMBER \
    ./build/sourcemaps

Hermes bytecode:

bash

# Hermes requires source maps - verify with:
sentry-cli sourcemaps explain <event-id>

Verification Checklist

Release builds upload symbols automatically
CI pipeline includes symbol upload step
Test crash shows readable stack trace
Source maps include original source (not just line numbers)
Build numbers match between app and uploaded symbols

Common Issues

Symptom	Cause	Fix
`<redacted>` in stack	Missing dSYM	Upload dSYM for that build
Line numbers wrong	Source map mismatch	Verify release/dist strings match
Only framework symbols	App dSYM missing	Check archive includes app dSYM
`<unknown>` in RN	Hermes without source maps	Configure Hermes source map generation

Vendor Commands

Vendor	Verify Upload
Sentry	`sentry-cli debug-files check <UUID>`
Crashlytics	Firebase Console → Crashlytics → Missing dSYMs
Bugsnag	`bugsnag-cli upload` with `--dry-run`
Datadog	Dashboard → Error Tracking → Symbol Files
bitdrift	Dashboard or CLI for dSYM, Gradle plugin for ProGuard
New Relic	iOS dSYM via build script or `newrelic-cli`; Android ProGuard auto-uploaded by NR Gradle plugin

See skills/crash-instrumentation for breadcrumb strategies and crash context
Symbolication is Tier 1 in skills/instrumentation-planning

Files

Just SKILL.md in skills/symbolication-setup of nexus-labs-automation/mobile-observability.

Open the folder on GitHubat commit 488c97f

Compare with similar skills

Symbolication Setup next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Symbolication Setup compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Symbolication Setup this skillnexus-labs-automation/mobile-observability	116	—	~996	Automated safety check: Pass	MIT	1 mo ago
Expo Brownfield Integrationmweinbach/agent-coworker	156	2 repos	~900	Automated safety check: Notes	Custom licence	yesterday
Upgrading React Nativecallstackincubator/agent-skills	1.7k	1 repos	~1.1k	Automated safety check: Pass	MIT	yesterday
Diagnosing Stacktrace SymbolicationPostHog/posthog	40k	—	~2.2k	Automated safety check: Pass	Custom licence	today
Upgrade React NativeShopify/flash-list	7.2k	—	~1.9k	Automated safety check: Pass	MIT	8 days ago
Debugging SurveysPostHog/posthog	40k	—	~7.1k	Automated safety check: Pass	Custom licence	today

Similar skills

Expo Brownfield Integration
mweinbach/agent-coworker
Helps add Expo and React Native to an existing native iOS or Android app, and choose between a prebuilt AAR or XCFramework and a fully integrated build.
156 GitHub starsUsed in 2 repos~900 tokens
MobileAuto-check: notes
Upgrading React Native
callstackincubator/agent-skills
Official
Upgrades React Native apps to newer versions by applying rn-diff-purge template diffs, updating package.json dependencies, migrating native iOS and Android configuration, resolving CocoaPods and…
1.7k GitHub starsUsed in 1 repo~1.1k tokens
MobileAuto-check passed
Diagnosing Stacktrace Symbolication
PostHog/posthog
Official
Help users debug PostHog Error Tracking stack-trace symbolication for any supported platform — JavaScript/TypeScript web, React Native (Hermes), Android (Proguard / R8), or iOS / macOS (dSYM).
40k GitHub stars~2.2k tokensUpdated today
MobileAuto-check passed
Upgrade React Native
Shopify/flash-list
Official
Upgrade the React Native fixture app to a new version. An agent skill from Shopify/flash-list.
7.2k GitHub stars~1.9k tokensUpdated 8 days ago
MobileAuto-check passed
Debugging Surveys
PostHog/posthog
Official
Diagnose PostHog Surveys configuration and responses across all five SDKs (web/posthog-js, iOS, Android, Flutter, React Native).
40k GitHub stars~7.1k tokensUpdated today
MobileAuto-check passed
Rnrepo
software-mansion-labs/skills
Best practices for integrating and using RNRepo — Software Mansion's infrastructure for pre-built React Native library artifacts that reduces native build times by up to 2×.
291 GitHub stars~611 tokensUpdated 12 days ago
MobileAuto-check passed

Questions about Symbolication Setup

What does Symbolication Setup do?

Configure crash symbolication for readable stack traces. An agent skill from nexus-labs-automation/mobile-observability. Symbolication Setup is an agent skill from nexus-labs-automation/mobile-observability. Configure crash symbolication for readable stack traces.

When should I use Symbolication Setup?

Symbolication Setup fits situations like: setting up dSYMs (iOS); proGuard/R8 mappings (Android); source maps (React Native).

How do I install Symbolication Setup in Claude Code?

Run `npx skills add nexus-labs-automation/mobile-observability --skill symbolication-setup -a claude-code`. Or copy the skill folder (skills/symbolication-setup in nexus-labs-automation/mobile-observability) into .claude/skills/symbolication-setup in your project. Claude Code loads it when a task matches its description.

How do I install Symbolication Setup in Codex?

Run `npx skills add nexus-labs-automation/mobile-observability --skill symbolication-setup -a codex`. Or copy the skill folder (skills/symbolication-setup in nexus-labs-automation/mobile-observability) into .agents/skills/symbolication-setup in your project. Codex loads it when a task matches its description.

Can I use Symbolication Setup in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add nexus-labs-automation/mobile-observability --skill symbolication-setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/symbolication-setup, .gemini/skills/symbolication-setup, .github/skills/symbolication-setup and .opencode/skills/symbolication-setup in your project.

What does Symbolication Setup need to run?

SKILL.md names no scripts, command-line tools or credentials: Symbolication Setup is instructions for the agent only.

Does Symbolication Setup access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Symbolication Setup safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Symbolication Setup use?

Symbolication Setup is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Symbolication Setup use?

About 996 tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Symbolication Setup?

Skills that share tags, products or a category with Symbolication Setup: Expo Brownfield Integration (mweinbach/agent-coworker, 156 stars), Upgrading React Native (callstackincubator/agent-skills, 1.7k stars), Diagnosing Stacktrace Symbolication (PostHog/posthog, 40k stars) and Upgrade React Native (Shopify/flash-list, 7.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Symbolication Setup?

nexus-labs-automation (a GitHub organization) maintains it in nexus-labs-automation/mobile-observability, which has 116 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on August 23, 2026.

Source: nexus-labs-automation/mobile-observability on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Symbolication Setup

Facts

At a glance

What it does

When your agent uses it

Example prompts

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Symbolication Setup

Why It Matters

Platform Setup

iOS (dSYMs)

Android (ProGuard/R8)

React Native (Source Maps)

Verification Checklist

Common Issues

Vendor Commands

Related Skills

Files

Compare with similar skills

Similar skills

More from nexus-labs-automation/mobile-observability

Related

Questions about Symbolication Setup