Skip to content

hashgraph-online/awesome-codex-plugins / plugins/ChannelerH/codex-skin-packs/skills/codex-skin-pack-installer

codex-skin-pack-installer

Verified

Install Codex themes and Codex skin packs with npx skills. Use this skill when a user wants Codex to find, download, validate, apply, switch, remix, or restore Codex desktop themes such as caishen-readable, caishen-lite, mythic-guardian-noir, global-founder-bright, export-night, or caishen-max. It stages verified public-safe theme packs from ChannelerH/codex-skin-packs, checks theme.json/background.png, preserves the native Codex layout, avoids private workspace screenshots, and provides restore guidance.

FileKindSize
SKILL.mdskill md3.8 KB
agents/openai.yamlconfig267 B
scripts/fetch_skin_pack.pyexecutablescript4.5 KB

scripts/fetch_skin_pack.py

View on GitHub
#!/usr/bin/env python3
"""Download and stage verified Codex skin packs."""

from __future__ import annotations

import argparse
import datetime as dt
import json
import os
import shutil
import sys
import tempfile
import urllib.request
import zipfile
from pathlib import Path


RELEASE_BASE = "https://github.com/ChannelerH/codex-skin-packs/releases/download/v0.1.0"

PACKS = {
    "caishen-readable": "Lower-strain fortune skin.",
    "caishen-lite": "Soft fortune skin with readable working areas.",
    "caishen-max": "Brighter fortune skin for short immersive sessions.",
    "global-founder-bright": "Bright international growth/workspace skin.",
    "export-night": "Dark export-ops skin.",
    "mythic-guardian-noir": "Dark mythic focus skin.",
}


def fail(message: str) -> None:
    print(f"error: {message}", file=sys.stderr)
    raise SystemExit(1)


def safe_extract(zip_path: Path, destination: Path) -> None:
    destination = destination.resolve()
    with zipfile.ZipFile(zip_path) as archive:
        for member in archive.infolist():
            target = (destination / member.filename).resolve()
            if destination != target and destination not in target.parents:
                fail(f"unsafe zip path: {member.filename}")
        archive.extractall(destination)


def locate_pack_root(destination: Path) -> Path:
    candidates = []
    for path in [destination, *destination.iterdir()]:
        if path.is_dir() and (path / "theme.json").is_file() and (path / "background.png").is_file():
            candidates.append(path)
    if not candidates:
        fail("staged pack must contain theme.json and background.png")
    return candidates[0]


def validate_theme(pack_root: Path) -> None:
    theme_path = pack_root / "theme.json"
    try:
        json.loads(theme_path.read_text(encoding="utf-8"))
    except json.JSONDecodeError as exc:
        fail(f"theme.json is invalid JSON: {exc}")


def download(url: str, destination: Path) -> None:
    request = urllib.request.Request(url, headers={"User-Agent": "codex-skin-pack-installer"})
    with urllib.request.urlopen(request, timeout=60) as response:
        if response.status >= 400:
            fail(f"download failed with HTTP {response.status}")
        with destination.open("wb") as handle:
            shutil.copyfileobj(response, handle)


def stage_pack(slug: str, output_dir: Path) -> Path:
    if slug not in PACKS:
        fail(f"unknown pack '{slug}'. Run with --list to see available packs.")

    url = f"{RELEASE_BASE}/{slug}.zip"
    destination = output_dir.expanduser() / slug

    with tempfile.TemporaryDirectory(prefix="codex-skin-pack-") as temp_dir:
        temp_root = Path(temp_dir)
        zip_path = temp_root / f"{slug}.zip"
        staging = temp_root / "staged"
        staging.mkdir()
        download(url, zip_path)
        safe_extract(zip_path, staging)

        pack_root = locate_pack_root(staging)
        validate_theme(pack_root)

        if destination.exists():
            shutil.rmtree(destination)
        destination.mkdir(parents=True, exist_ok=True)

        if pack_root == staging:
            final_pack_root = destination
            for child in pack_root.iterdir():
                shutil.move(str(child), final_pack_root / child.name)
        else:
            final_pack_root = destination / pack_root.name
            shutil.move(str(pack_root), final_pack_root)

    manifest = {
        "slug": slug,
        "source": url,
        "stagedAt": dt.datetime.now(dt.timezone.utc).isoformat(),
        "packRoot": str(final_pack_root),
    }
    (destination / "source.json").write_text(json.dumps(manifest, indent=2) + "\n", encoding="utf-8")
    return final_pack_root


def main() -> None:
    parser = argparse.ArgumentParser(description="Download and stage verified Codex skin packs.")
    parser.add_argument("slug", nargs="?", help="Pack slug to stage")
    parser.add_argument(
        "--out",
        default=os.path.expanduser("~/.codexthemes/packs"),
        help="Output directory, default: ~/.codexthemes/packs",
    )
    parser.add_argument("--list", action="store_true", help="List available packs")
    args = parser.parse_args()

    if args.list:
        for slug, description in PACKS.items():
            print(f"{slug}\t{description}")
        return

    if not args.slug:
        fail("missing pack slug. Run with --list to see available packs.")

    pack_root = stage_pack(args.slug, Path(args.out))
    print(f"staged: {pack_root}")
    print("next: apply with your active Codex theme manager, then verify readability and restore path.")


if __name__ == "__main__":
    main()
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 468kUpdated Claude CodeCodexUnverifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 321kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 321kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 321kUpdated Claude CodeCodexVerifiedInstall