gh-assets-branch-mgmt

Manage a GitHub assets branch and upload PR visuals with stable raw URLs.

31|6|Updated Dec 13, 2025
One-click install
npx skills add https://github.com/WaterplanAI/agentic-config --skill gh-assets-branch-mgmt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gh-assets-branch-mgmt
Source: https://github.com/WaterplanAI/agentic-config/tree/main/core/skills/gh-assets-branch-mgmt
Command: npx skills add https://github.com/WaterplanAI/agentic-config --skill gh-assets-branch-mgmt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, jq, ffmpeg, ffprobe, bc, base64, and includes scripts (resource) components.

What problem does it solve?

This Skill automates persistent image hosting for GitHub PRs by creating and using an orphan assets branch, uploading assets, and generating raw URLs that do not rely on expiring CDN tokens.

Core Features & Use Cases

  • Orphan assets branch management: Creates and maintains a dedicated assets branch with stable URLs for assets.
  • Asset upload & URLs: Uploads screenshots, videos, and images to context-specific paths and provides raw blob URLs ready for embedding in PRs.
  • Video handling & conversion: Converts videos to H.264 MP4 and GIF formats for inline PR embedding, with deterministic processing and proper size handling.
  • Use Case: When a PR includes multiple screenshots and a demo video, run a single command to publish assets and embed links in the PR description.

Quick Start

Initialize the assets branch and upload assets with:

  • /gh-assets-branch-mgmt init
  • /gh-assets-branch-mgmt upload outputs/screenshots --context pr-42

Frequently Asked Questions about gh-assets-branch-mgmt

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

FAQPage Schema
How do I host images and videos persistently in GitHub PRs without relying on expiring links?

Persistent PR hosting uses a dedicated assets branch to store and serve raw URLs that remain stable indefinitely. This Skill automates branch creation, asset uploads via the GitHub Contents API, and generates permanent raw blob URLs for embedding screenshots, images, and videos in PR descriptions without CDN token expiration.

Can I automate video conversion to MP4 and GIF formats for PR embedding?

Yes. This Skill converts videos to H.264 MP4 and GIF formats automatically using ffmpeg and ffprobe, handling deterministic processing and size constraints so videos embed cleanly in PRs without manual format conversion.

What do I need to set up before uploading assets to a GitHub PR?

You need the gh CLI for authentication and API access, jq for JSON processing, ffmpeg and ffprobe for video handling, bc for calculations, and base64 encoding support. The Skill initializes an orphan assets branch once, then manages uploads and URL generation automatically.

How do I organize and upload multiple screenshots and videos to a single PR?

Initialize the assets branch with a single command, then upload asset directories with context-specific paths (e.g., pr-42) to organize assets by PR. The Skill generates raw URLs for all assets in one operation, ready for embedding in the PR description.

What's the difference between this approach and uploading assets directly to a PR comment?

Direct PR uploads expire or rely on CDN tokens; an assets branch provides permanent, stable URLs that survive forever. This Skill uses an orphan branch and the GitHub Contents API to create durable hosting independent of GitHub's temporary storage.

Does this work if my repository already has multiple branches?

Yes. An orphan assets branch is independent of your main branch history, so it coexists with existing branches without affecting your repository structure or merge workflows.