ipsw-skill

Скилл учит агента разбирать прошивки и бинарные файлы Apple через CLI ipsw: ядро, dyld_shared_cache, песочница, диффы.

  • 106 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Широкий доступ

Почему такой уровень

  • Скилл ведет работу с прошивками, ядром, песочницей и правами Apple, инструмент двойного назначения для исследований безопасности.
Все причины и проверки

blacktop/ipsw-skill

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/ipsw-skill

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Скилл ведет работу с прошивками, ядром, песочницей и правами Apple, инструмент двойного назначения для исследований безопасности.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

ipsw-skill — скилл для обратной разработки прошивок и бинарных файлов Apple поверх CLI `ipsw`. Агент сначала смотрит IPSW и OTA удаленно и вытаскивает один компонент, не скачивая весь образ. Дальше он работает с ядром и расширениями KEXT, с `dyld_shared_cache` для поиска символов, дизассемблирования и перекрестных ссылок, с заголовками ObjC и Swift, которые сравнивает между релизами. Отдельные справочники покрывают профили песочницы и права приложений, диффы между сборками, символизацию паник и крэшей и подключенные по USB устройства. Скилл `ipsw/` с `SKILL.md` лежит рядом с манифестами плагинов для Claude Code и Codex. Он поддерживает также Antigravity, Gemini CLI и Pi.

Для кого. Исследователям безопасности и разработчикам под Apple, которые разбирают прошивки, ядро и системные библиотеки вместе с агентом.

Подходит, если

  • Нужно узнать, что лежит в пакете эксклава свежего IPSW, не скачивая образ целиком.
  • Между двумя бета-сборками ищут, какие KEXT и методы ObjC изменились.
  • Панику ядра символизируют по логу и ищут функцию.
  • Нужно понять, какие профили песочницы открывают конкретный пользовательский клиент ядра.

Не подходит, если

  • Нужна обычная разработка приложений: скилл целиком про анализ прошивок.
  • Нельзя ставить `ipsw`: без него инструкции не работают.
  • Нужен анализ чужих систем без права на него: скилл описывает инструмент и не заменяет разрешение.

Пример запроса к агенту

Достань только `kernelcache` из последней бета-версии iOS и скажи, какие KEXT изменились.

Ограничения

Нужен установленный CLI `ipsw`, например `brew install blacktop/tap/ipsw`: скилл только описывает работу с ним. На каждого агента выбирайте один способ установки, иначе скилл загрузится дважды под именами `ipsw` и `ipsw:ipsw`. Инструмент работает с прошивками, ядром, песочницей и правами приложений, поэтому применять его нужно для исследований, на которые у вас есть право. Последний коммит в репозитории сделан в сентябре 2026.

Как отключить. Для Claude Code выполните `claude plugin uninstall ipsw@ipsw-skill`, для остальных удалите папку `ipsw/` из каталога скиллов. CLI `ipsw` удаляется отдельно через `brew uninstall`.

Частые вопросы

Как поставить скилл через skills.sh?

Сначала поставьте CLI `brew install blacktop/tap/ipsw`, затем выполните `npx skills add https://github.com/blacktop/ipsw-skill --skill ipsw`.

Как поставить в Claude Code?

Выполните `claude plugin marketplace add blacktop/ipsw-skill`, затем `claude plugin install ipsw@ipsw-skill`.

Как обновить скилл?

Для skills.sh выполните `npx skills update`, для плагина Claude Code `claude plugin update ipsw@ipsw-skill`. Автообновление для сторонних маркетплейсов выключено.

Нужно ли скачивать весь IPSW?

Нет. Скилл ведет работу удаленно и вытаскивает отдельные компоненты, например ядро или dyld_shared_cache.

Какие агенты поддерживаются?

Claude Code, Codex CLI, Antigravity, Gemini CLI и Pi.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Скилл для Claude Code распаковывает IPA, находит API-эндпоинты, секреты и уязвимости, разбирает бинарные файлы Mach-O.

СкиллШирокий доступ120Звезды репозитория

122 скилла для обратной разработки: вредоносные программы, прошивки, протоколы, мобильные приложения, CTF и поиск уязвимостей.

ПлагинШирокий доступ239Звезды репозитория
Выбор редакции

Сканер безопасности для скиллов и MCP агентов: ищет промпт-инъекции, утечки данных и риски цепочки поставок до установки

CLIРасширенный доступ25,5 тыс.Звезды репозитория

VibeSec

VibeSec-Skill

Скилл безопасной разработки: агент смотрит на код глазами багхантера и предотвращает типовые уязвимости веб-приложений

СкиллМинимальный доступ1,4 тыс.Звезды репозитория

Сканер безопасности для скиллов агентов: ищет промпт-инъекции, утечку данных и вредоносный код перед установкой

CLIРасширенный доступ2,7 тыс.Звезды репозитория

Сканер скиллов Claude Code проверяет всю папку скилла, а не только SKILL.md, и ставит скилл только после вашего решения.

CLIМинимальный доступ85Звезды репозитория

Коротко о README

В репозитории папка `ipsw/` с `SKILL.md` и справочниками по загрузке, прошивкам, `dyld`, `class-dump`, Mach-O, ядру, песочнице, правам, диффам, символизации и устройствам. Манифесты плагинов для Claude Code и Codex лежат отдельно, версия скилла указана в `metadata.version`.

Бейдж для README

Исходный SKILL.md

---
name: ipsw
description: Reverse-engineers Apple firmware and binaries with the ipsw CLI. Inspects IPSWs and OTAs remotely or locally; extracts kernelcaches, dyld_shared_cache, exclave, SEP, and coprocessor firmware; disassembles and cross-references DSC dylibs, KEXTs, and Mach-Os; dumps and diffs ObjC/Swift headers; decompiles and queries sandbox profiles; searches entitlements; symbolicates crashes and panics; and diffs releases. Use for iOS/macOS internals, private frameworks, kernel or firmware research, and Apple security research, even when ipsw is not named.
license: MIT
metadata:
  version: "2.0.0"
  ipsw-version: "3.1.725-6-g6e0291a8f"
---

# ipsw

`ipsw` is one CLI for Apple firmware work, organized into command groups (`download`,
`extract`, `dyld`, `kernel`, `macho`, `fw`, `sb`, `ent`, `diff`, `symbolicate`, `idev`, ...).
Install it with `brew install blacktop/tap/ipsw` (other platforms: github.com/blacktop/ipsw
releases). Remote and download commands need network access; `idev` needs a USB-connected
device. This skill describes ipsw as of commit 6e0291a8f (after release 3.1.725); on 3.1.725
and earlier, apply the "Older releases" table below. Flags change between releases:
`ipsw version` shows the installed build, and `ipsw <group> <command> --help` is the source of
truth. Commands marked 🚧 in `--help` are works in progress.

Examples use these shell variables (POSIX sh/bash/zsh syntax):

```bash
IPSW=./iPhone18,1_26.4_23E246_Restore.ipsw   # local IPSW or OTA
URL=https://updates.cdn-apple.com/...          # remote IPSW or OTA (see "Triage a release")
DSC=./dyld_shared_cache_arm64e                 # main file of an extracted cache; subcaches beside it
KC=./kernelcache.release.iPhone18,1            # extracted kernelcache
DEVICE=iPhone18,1                              # any product type from `ipsw device-list`
```

## Working rules

These are where agents most often go wrong with ipsw.

1. **Make every choice explicit on the command line.** Without a terminal, ipsw cannot prompt:
   the command stops with an error such as "use --confirm to proceed unattended" (older
   releases skip the step silently; see "Older releases" below). Pass the selection instead:
   - A short dylib name that matches several images (`UIKit`, `SwiftUI`, `SpringBoard`) fails.
     Pass the full install path, found with
     `ipsw dyld info --dylibs --json "$DSC" | jq -r '.dylibs[].name' | grep -i <name>`.
   - Fat Mach-Os need `--arch arm64e`; multi-device IPSWs need `--device <product-type>`.
   - Downloads and payload searches need `-y`/`--confirm` (`download`, `ota extract --pattern`).
   - `ipsw mount` blocks until Ctrl+C: pass `--detach`, then run the `hdiutil detach …`
     command it prints.
   - `idev crash pull` needs a path or `--all`; `idev syslog` streams forever unless given

Сообщить о проблеме