Skip to content
Skillpedia
Misc42k · #4715

competition-firmware-layout

Helps your agent understand the content of device firmware images. It can extract files, map how data is organized, and inspect security settings.

What it does

This tool helps understand how firmware (a device's internal software) is organized. It maps out the different parts, how they connect, and how the device boots or updates.

When to use it

  • ✓When you need to see how firmware is structured.
  • ✓To understand the boot or update order of a device.
  • ✓When trying to find secrets or passwords within the firmware.

Example of what to ask your AI

“Analyze the structure of this firmware and show me its boot process.”

Want more? Open the sections below.

How to use

The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.

Skill link

https://github.com/zhaoxuya520/reverse-skill/blob/main/CTF-Sandbox-Orchestrator/competition-firmware-layout/SKILL.md

Ready-to-paste message

Use this skill to help me: https://github.com/zhaoxuya520/reverse-skill/blob/main/CTF-Sandbox-Orchestrator/competition-firmware-layout/SKILL.md Read the SKILL.md file at that link and follow its instructions for my task.
How it works

The tool examines the firmware file, identifies its components (like partitions and file systems), and traces the boot or update process. It organizes this information for easy understanding.

Installation

Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.

In the terminal (Claude Code, Codex, Cursor), in your project folder:

npx skills add zhaoxuya520/reverse-skill --skill competition-firmware-layout

Or download just the file:

curl -L https://raw.githubusercontent.com/zhaoxuya520/reverse-skill/main/CTF-Sandbox-Orchestrator/competition-firmware-layout/SKILL.md -o SKILL.md
Technical content (original SKILL.md)

Original text by the author, straight from GitHub.

Competition Firmware Layout

Use this skill only as a downstream specialization after $ctf-sandbox-orchestrator is already active and has established sandbox assumptions, node ownership, and evidence priorities. If that has not happened yet, return to $ctf-sandbox-orchestrator first.

Use this skill when the hard part is understanding how a firmware image is structured, booted, updated, and turned into reachable device behavior.

Reply in Simplified Chinese unless the user explicitly requests English.

Quick Start

  1. Preserve the original image, extracted partitions, unpacked filesystems, and patched copies as separate artifacts.
  2. Map outer container, partition table, bootloader, kernel, rootfs, config, and update metadata before editing anything.
  3. Track the boot or update chain in order instead of jumping straight to the most interesting file.
  4. Record keys, signatures, offsets, partition boundaries, and init entrypoints in one compact evidence chain.
  5. Reproduce the decisive secret, branch, or reachable service from the smallest extracted path.

Workflow

1. Establish Image Layout

  • Identify container type, partition headers, compression, filesystem type, and any appended or nested images.
  • Record offsets, sizes, hashes, mount points, and partition names before extraction mutates anything.
  • Separate bootloader, kernel, initramfs, rootfs, config blobs, and update metadata as different layers.

2. Trace Boot Or Update Flow

  • Map how control moves from bootloader to kernel to init to services, or from update package to verifier to installer.
  • Note which credentials, certificates, passwords, seeds, or config files are consumed at each stage.
  • Distinguish checked-in firmware intent from the live behavior the extracted files actually support.

3. Reduce To The Decisive Path

  • Show the smallest chain from image boundary to service exposure, auth bypass, debug interface, credential recovery, or flag artifact.
  • Keep extracted filesystems, derived configs, and patch experiments separate from pristine inputs.
  • If the challenge becomes mostly about native crash behavior or exploit primitives after extraction, switch back to the broader reverse skill.

Read This Reference

  • Load references/firmware-layout.md for the layout checklist, boot-chain checklist, and evidence packaging.

What To Preserve

  • Partition offsets, hashes, filesystem types, mount paths, boot entrypoints, and update metadata
  • Extracted secrets, config paths, init scripts, service units, and credentials tied to the stage that consumes them
  • Original images, extracted layers, mounted views, and patched copies as separate artifacts
FAQ

What are 'partitions' in firmware?

They are like divisions within the firmware file, each holding different types of information, such as the operating system or settings.

What does 'trace the boot flow' mean?

It means following the path the device's internal software takes from power-on to being ready for use, identifying which parts are used at each step.

Why is it important to preserve original files?

To ensure you can return to the initial state if something goes wrong during analysis or modification, and to have a clear reference of what was found.

Details

Original description by the author

Internal downstream skill for ctf-sandbox-orchestrator. CTF-sandbox workflow for firmware images, partition tables, boot chains, update packages, extracted filesystems, embedded configs, and device-facing trust boundaries. Use when the user asks to unpack firmware, map partition layout, inspect bootloader or init chains, recover update keys or credentials, trace config loading, or explain how a de

repo: zhaoxuya520/reverse-skill

Popularity

GitHub stars
42k
Ranking position
#4715
License
MIT
Updated
9/22/2026

Is this skill useful?

0

Sign in to vote.

Comments

  • …

More skills from this repository

Similar skills