skills.rest
JORDAN0615
JORDAN0615COMMUNITY
Explore all skills by this author →
GitHub

jetson-promote-image

Automates two-channel staging of overlay files and kernel artifacts into a Jetson BSP image.

1|Updated Jun 12, 2026
Search Tags:#kernel#artifact#overlay#bsp#promote#jetson#initramfs
One-click install
npx skills add https://github.com/JORDAN0615/bsp_factory --skill jetson-promote-image
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: jetson-promote-image
Source: https://github.com/JORDAN0615/bsp_factory/tree/main/skills/jetson-promote-image
Command: npx skills add https://github.com/JORDAN0615/bsp_factory --skill jetson-promote-image

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Manually copying customized BSP overlay files and rebuilt kernel artifacts to a staged BSP image is error-prone, risks missing critical files, and can lead to stale kernel/module version mismatches that cause boot failures on Jetson devices.

Core Features & Use Cases

  • Two-channel automated promotion: Copies both overlay customization outputs (e.g., config files, hand-edited device tree blobs) and build artifacts (kernel Image, in-tree/out-of-tree modules, NVIDIA DTBs) from the source workspace to the staged BSP image.
  • Diff-aware idempotent operation: Skips byte-identical files, so re-runs are safe and automatically resume if interrupted by errors like permission issues or disk full.
  • Automatic initramfs coherence: Mirrors updated kernel images to the rootfs and rebuilds the initramfs when kernel or module files change, eliminating boot failures from module shadowing or symbol version skew.
  • Use Case: After customizing fan control configs and rebuilding the kernel for a Jetson Orin NX, use this skill to stage all changes into the BSP image in one step, with no manual copy work or risk of stale boot files.

Quick Start

Use the jetson-promote-image skill to automatically stage all customized overlay files and rebuilt kernel artifacts from your active Jetson BSP workspace into the staged BSP image, preparing it for flashing to a device.

Frequently Asked Questions about jetson-promote-image

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I stage rebuilt kernel artifacts and overlay files into a Jetson BSP image for flashing?▼

To stage a Jetson BSP image, you can automate the two-channel promotion of customized overlay files and rebuilt kernel artifacts into a coherent, flash-ready image, eliminating manual copy errors and stale file mismatches.

Why does my Jetson device fail to boot after manually copying rebuilt kernel modules to the BSP rootfs?▼

Boot failures after manual kernel module copies often stem from symbol version skew. Automating BSP promotion with an automatic initramfs refresh aligns kernel and module versions, preventing module shadowing and boot errors.

What is the best way to ensure my Jetson initramfs stays coherent with newly promoted kernel images?▼

The best way to ensure initramfs coherence during Jetson BSP promotion is to use a process that automatically mirrors updated kernel images to the rootfs and rebuilds the initramfs when kernel or module files change.

Can I safely re-run a Jetson BSP image staging process if a file copy was interrupted by a disk full error?▼

Yes, you can safely re-run Jetson BSP staging after interruptions. A diff-aware idempotent operation skips byte-identical files, so re-runs automatically resume without duplicating completed work.

Does diff-aware BSP artifact promotion prevent stale device tree blobs from being flashed to a Jetson Orin NX?▼

Yes, diff-aware promotion prevents stale artifacts by validating build-source freshness. It ensures only the latest customized device tree blobs and config edits are copied to the staged Jetson BSP image.

When do I need to automate Jetson BSP artifact staging instead of copying files manually?▼

You need to automate Jetson BSP artifact staging when you have completed overlay customizations or kernel rebuilds and require a coherent, flash-ready image without the risk of missing critical files or version mismatches.

Related Skills

Explore More Software Engineering Skills→
JORDAN0615JORDAN0615

jetson-build-source

Rebuilds changed Jetson BSP kernel artifacts and generates a trace-to-dirty manifest.

Community
Advanced
JORDAN0615JORDAN0615

jetson-validate-image

Validate deployed Jetson BSP images via static artifact checks and on-target tests.

Community
Intermediate
NVIDIA-AI-IOTNVIDIA-AI-IOT
46

jetson-promote-image

Promote overlay files and built artifacts into staged Jetson Linux BSP images.

Official
Advanced
JORDAN0615JORDAN0615

jetson-customize-camera

Generate validated kernel device-tree overlays for MIPI/GMSL camera sensors on custom Jetson carrier boards.

Community
Advanced