Skip to content
Back to search

ipsw-skill

MarketplaceWorks with Claude CodeGitHub

A SKILL.md for ipsw

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/blacktop--ipsw-skill/badge.svg)](/listings/blacktop--ipsw-skill)

HTML

<a href="/listings/blacktop--ipsw-skill"><img src="/api/listings/blacktop--ipsw-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

Install the `ipsw` CLI tool:

brew install blacktop/tap/ipsw

Pick one install method per agent. Installing both a plugin and a standalone copy loads the skill twice (`ipsw` and `ipsw:ipsw`).

skills.sh

npx skills add https://github.com/blacktop/ipsw-skill --skill ipsw

Claude Code

Install from the marketplace:

claude plugin marketplace add blacktop/ipsw-skill
claude plugin install ipsw@ipsw-skill

Or install manually:

git clone https://github.com/blacktop/ipsw-skill /tmp/ipsw-skill

# User-wide (available in all projects)
mv /tmp/ipsw-skill/ipsw ~/.claude/skills/ipsw

# Project-specific (check into your repo)
mv /tmp/ipsw-skill/ipsw .claude/skills/ipsw

Codex CLI

Install from the marketplace:

codex plugin marketplace add blacktop/ipsw-skill
codex plugin add ipsw@ipsw-skill

Or use the built-in skill installer:

$skill-installer https://github.com/blacktop/ipsw-skill --path ipsw

Or install manually:

git clone https://github.com/blacktop/ipsw-skill /tmp/ipsw-skill

# User-wide
mv /tmp/ipsw-skill/ipsw ~/.codex/skills/ipsw

# Project-specific
mv /tmp/ipsw-skill/ipsw .codex/skills/ipsw

Antigravity

Install the skill manually:

git clone https://github.com/blacktop/ipsw-skill /tmp/ipsw-skill

# Workspace-specific
mv /tmp/ipsw-skill/ipsw <workspace-root>/.agents/skills/ipsw

# User-wide (all workspaces)
mv /tmp/ipsw-skill/ipsw ~/.gemini/config/skills/ipsw

Run `/skills` in Antigravity CLI (`agy`) to confirm it loaded. Older Antigravity releases read `.agent/skills/` instead of `.agents/skills/`. On first launch, `agy` also imports skills already installed for Gemini CLI.

Gemini CLI

Google stopped serving Gemini CLI for individual accounts on June 18, 2026; enterprise and paid API-key users can install the skill natively:

gemini skills install https://github.com/blacktop/ipsw-skill --path ipsw

Pi (pi-coding-agent)

# Global (adds package to ~/.pi/agent/settings.json; clones to ~/.pi/agent/git/...)
pi install https://github.com/blacktop/ipsw-skill

# Project-local (adds package to ./.pi/settings.json; clones to ./.pi/git/...)
pi install -l https://github.com/blacktop/ipsw-skill

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 17 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "ipsw-skill",
  3. "owner": {
  4. "name": "blacktop"
  5. },
  6. "metadata": {
  7. "description": "Apple firmware and binary reverse engineering skills using the ipsw CLI tool",
  8. "version": "2.0.0"
  9. },
  10. "plugins": [
  11. {
  12. "name": "ipsw",
  13. "description": "Apple firmware and binary reverse engineering using the ipsw CLI tool",
  14. "source": "./"
  15. }
  16. ]
  17. }
README.md · README · 188 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # ipsw-skill
  2. An AI agent skill for Apple firmware and binary reverse engineering using the [ipsw](https://github.com/blacktop/ipsw) CLI tool.
  3. Supports **Claude Code**, **Codex CLI**, **Antigravity**, **Gemini CLI**, and **Pi (pi-coding-agent)**.
  4. ## What This Skill Provides
  5. This skill empowers AI agents to assist with:
  6. - **Remote-first firmware triage** - inspect IPSWs/OTAs and pull single components without downloading the whole image
  7. - **Firmware components** - kernelcaches, dyld_shared_cache, exclave/SEP/SPTM/coprocessor firmware, IMG4, AEA, OTA payloads
  8. - **Userspace reverse engineering** - DSC symbol lookup, disassembly, xrefs, imports, soft links
  9. - **ObjC/Swift headers** - dump private framework interfaces and diff them between releases
  10. - **Kernel & KEXT analysis** - symbolication, C++ classes, syscalls/MIG, KEXT extraction
  11. - **Sandbox and entitlements** - decompile profiles, capability queries, entitlement search
  12. - **Release diffing and crash symbolication** - patch hunting between builds, panics and crash logs
  13. ## Installation
  14. ### Prerequisites
  15. Install the `ipsw` CLI tool:
  16. ```bash
  17. brew install blacktop/tap/ipsw
  18. ```
  19. Pick one install method per agent. Installing both a plugin and a standalone copy loads the skill
  20. twice (`ipsw` and `ipsw:ipsw`).
  21. ### skills.sh
  22. ```bash
  23. npx skills add https://github.com/blacktop/ipsw-skill --skill ipsw
  24. ```
  25. ### Claude Code
  26. Install from the marketplace:
  27. ```bash
  28. claude plugin marketplace add blacktop/ipsw-skill
  29. claude plugin install ipsw@ipsw-skill
  30. ```
  31. Or install manually:
  32. ```bash
  33. git clone https://github.com/blacktop/ipsw-skill /tmp/ipsw-skill
  34. # User-wide (available in all projects)
  35. mv /tmp/ipsw-skill/ipsw ~/.claude/skills/ipsw
  36. # Project-specific (check into your repo)
  37. mv /tmp/ipsw-skill/ipsw .claude/skills/ipsw
  38. ```
  39. ### Codex CLI
  40. Install from the marketplace:
  41. ```bash
  42. codex plugin marketplace add blacktop/ipsw-skill
  43. codex plugin add ipsw@ipsw-skill
  44. ```
  45. Or use the built-in skill installer:
  46. ```bash
  47. $skill-installer https://github.com/blacktop/ipsw-skill --path ipsw
  48. ```
  49. Or install manually:
  50. ```bash
  51. git clone https://github.com/blacktop/ipsw-skill /tmp/ipsw-skill
  52. # User-wide
  53. mv /tmp/ipsw-skill/ipsw ~/.codex/skills/ipsw
  54. # Project-specific
  55. mv /tmp/ipsw-skill/ipsw .codex/skills/ipsw
  56. ```
  57. ### Antigravity
  58. Install the skill manually:
  59. ```bash
  60. git clone https://github.com/blacktop/ipsw-skill /tmp/ipsw-skill
  61. # Workspace-specific
  62. mv /tmp/ipsw-skill/ipsw <workspace-root>/.agents/skills/ipsw
  63. # User-wide (all workspaces)
  64. mv /tmp/ipsw-skill/ipsw ~/.gemini/config/skills/ipsw
  65. ```
  66. Run `/skills` in Antigravity CLI (`agy`) to confirm it loaded. Older Antigravity releases read
  67. `.agent/skills/` instead of `.agents/skills/`. On first launch, `agy` also imports skills already
  68. installed for Gemini CLI.
  69. ### Gemini CLI
  70. Google stopped serving Gemini CLI for individual accounts on June 18, 2026; enterprise and paid
  71. API-key users can install the skill natively:
  72. ```bash
  73. gemini skills install https://github.com/blacktop/ipsw-skill --path ipsw
  74. ```
  75. ### Pi (pi-coding-agent)
  76. ```bash
  77. # Global (adds package to ~/.pi/agent/settings.json; clones to ~/.pi/agent/git/...)
  78. pi install https://github.com/blacktop/ipsw-skill
  79. # Project-local (adds package to ./.pi/settings.json; clones to ./.pi/git/...)
  80. pi install -l https://github.com/blacktop/ipsw-skill
  81. ```
  82. ## Updating
  83. Releases use semver (see [CHANGELOG.md](CHANGELOG.md)); `ipsw/SKILL.md` carries the version in
  84. `metadata.version`, along with the ipsw version it describes.
  85. | Installed with | Update |
  86. |---|---|
  87. | skills.sh | `npx skills update` |
  88. | Claude Code plugin | `claude plugin update ipsw@ipsw-skill` (auto-update is off for third-party marketplaces; turn it on under `/plugin` → Marketplaces) |
  89. | Codex plugin | `codex plugin marketplace upgrade ipsw-skill`, then `codex plugin add ipsw@ipsw-skill` |
  90. | Antigravity | re-clone and replace `ipsw/` in the skills directory |
  91. | Gemini CLI | re-run `gemini skills install ... --path ipsw` |
  92. | Pi | `pi update --extensions` |
  93. | Manual copy | re-clone and copy `ipsw/` again |
  94. ## Usage Examples
  95. Once installed, the agent will automatically use this skill for Apple RE tasks:
  96. > "What's in the exclave bundle of the latest iPhone 16 Pro IPSW? Don't download the whole thing."
  97. > "Grab just the kernelcache from the newest iOS beta and tell me which KEXTs changed"
  98. > "Disassemble _malloc from the system dyld_shared_cache"
  99. > "What ObjC methods did SpringBoardServices gain between these two caches?"
  100. > "Which sandbox profiles can open IOSurfaceRootUserClient in this kernelcache?"
  101. > "Symbolicate this panic log"
  102. ## Contents
  103. ```
  104. ipsw-skill/
  105. ├── ipsw/ # The skill (every agent reads this)
  106. │ ├── SKILL.md # Working rules, workflows, and a map of the references
  107. │ └── references/
  108. │ ├── download.md # Find URLs, remote reads, downloads, extraction, AEA keys
  109. │ ├── firmware.md # info/mount/dtree, fw components, IMG4, AEA, OTA payloads
  110. │ ├── dyld.md # dyld_shared_cache analysis
  111. │ ├── class-dump.md # ObjC/Swift dumping and API diffs
  112. │ ├── macho.md # Mach-O analysis, search, signing, patching
  113. │ ├── kernel.md # Kernelcache and KEXT analysis
  114. │ ├── sandbox.md # Sandbox profiles and capability queries
  115. │ ├── entitlements.md # Entitlement search and databases
  116. │ ├── diffing.md # Release diffs and patch hunting
  117. │ ├── symbolication.md # Crash and panic symbolication
  118. │ └── device.md # USB-connected devices (idev)
  119. ├── .claude-plugin/ # Claude Code marketplace + plugin manifest
  120. ├── .codex-plugin/plugin.json # Codex plugin manifest
  121. ├── .agents/plugins/ # Codex marketplace
  122. ├── package.json # Pi package manifest
  123. ├── scripts/check-versions.sh # CI: all manifests share one version
  124. └── CHANGELOG.md
  125. ```
  126. ## Resources
  127. - [ipsw Documentation](https://blacktop.github.io/ipsw)
  128. - [ipsw GitHub](https://github.com/blacktop/ipsw)
  129. - [Discord Community](https://discord.gg/BEamsHAWAh)
  130. ## License
  131. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.