pixel-asset-master 0.1.0__tar.gz

pixel_asset_master-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pixel Asset Master Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pixel_asset_master-0.1.0/PKG-INFO

@@ -0,0 +1,200 @@
+Metadata-Version: 2.4
+Name: pixel-asset-master
+Version: 0.1.0
+Summary: AI-driven 2D pixel game asset generation toolkit
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Pillow>=10.0.0
+Dynamic: license-file
+
+# Pixel Asset Master — AI generates 2D pixel game assets from game design briefs
+
+[![Version](https://img.shields.io/badge/version-v0.1.0-blue.svg)](#)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python](https://img.shields.io/badge/Python-3.8%2B-3776AB.svg)](https://www.python.org/)
+
+English | [中文](./README_CN.md)
+
+Drop in a game concept, art direction, or reference images — get back a structured pixel asset project with sprites, tiles, items, UI, effects, backgrounds, animation frames, sprite sheets, and export metadata.
+
+我是一名对游戏独立开发感兴趣的大学生，这个项目的灵感来自 PPT-master。它尝试把“用结构化流程辅助创作”的思路迁移到 2D 游戏像素素材生成中，让独立开发者可以更快整理美术方向、生成素材，并保留可复用的项目规范。
+
+## Project Example
+
+下面是一个水墨工笔像素风项目示例，包含两种树与竹子的动画展示。
+
+| Asset | Preview | Frames |
+|-------|---------|--------|
+| Cherry Blossom Tree | ![Cherry Blossom Tree Animation](./sakura_preview.gif) | 6-frame sprite sheet |
+| Willow Tree | ![Willow Tree Animation](./tree_willow_preview.gif) | 6-frame sprite sheet |
+| Bamboo | ![Bamboo Animation](./bamboo_preview.gif) | 4-frame sprite sheet |
+
+> **How it works** — Pixel Asset Master is a workflow skill for AI IDEs. You chat with an AI agent, confirm the style constraints, and the skill guides the agent through project setup, asset planning, generation, validation, and export.
+
+> **Local-first workflow** — Project files and generated assets are stored locally under `projects/`. API usage only depends on whatever AI tool or image provider you choose to connect.
+
+Pixel Asset Master focuses on:
+
+- **Game-ready structure** — assets are grouped by `characters`, `tiles`, `items`, `ui`, `effects`, and `backgrounds`.
+- **Strict visual contract** — `spec_lock.md` records canvas size, palette, style, color budget, and forbidden rendering patterns.
+- **Reusable templates** — built-in palettes, size presets, and sprite layout references.
+- **Validation tools** — scripts help check palette compliance, color budget, image format, and sprite sheet export.
+- **Agent-friendly process** — staged confirmations reduce vague prompts and keep long asset runs consistent.
+
+---
+
+## Quick Start
+
+### 1. Prerequisites
+
+| Dependency | Required? | What it does |
+|------------|:---------:|--------------|
+| Python 3.8+ | ✅ Yes | Runs the helper scripts |
+| Pillow | ✅ Yes | Image analysis, validation, quantization, and sprite sheet packing |
+
+Install the CLI tool with [uv](https://docs.astral.sh/uv/):
+
+```bash
+uv tool install .
+```
+
+This installs the `pam` (and `pixel-asset-master`) command globally. If you prefer to run without installing, use `uv run pam ...` from the repository root.
+
+### 2. Set Up
+
+**Option A — Download ZIP**: download the repository ZIP from GitHub and unzip it.
+
+**Option B — Git clone**:
+
+```bash
+git clone <your-repository-url>
+cd pixel-asset-master-skills
+uv tool install .
+```
+
+### 3. Put It Into Your AI Coding IDE
+
+After downloading or unzipping the repository, open the **entire `pixel-asset-master-skills/` folder** as a workspace in your AI coding IDE.
+
+| IDE | How to use |
+|-----|------------|
+| **Cursor** | `File → Open Folder...` and select `pixel-asset-master-skills/`. Ask the chat agent to read `skills/pixel-asset-master/SKILL.md`. |
+| **Trae** | Open the folder as a project/workspace. Then mention `skills/pixel-asset-master/SKILL.md` in chat before asking for assets. |
+| **Windsurf** | Open the folder in Windsurf. Use Cascade chat and reference `skills/pixel-asset-master/SKILL.md` when starting a pixel asset task. |
+| **Other AI coding IDEs** | Open the repository root as the workspace and point the agent to `skills/pixel-asset-master/SKILL.md`. |
+
+Recommended first prompt:
+
+```text
+Read skills/pixel-asset-master/SKILL.md and help me create a pixel art asset project.
+```
+
+### 4. Create a Pixel Asset Project
+
+```bash
+pam init demo --size 32x32 --palette DB32
+```
+
+The generated project is saved under `projects/` and is ignored by Git by default.
+
+### 5. Choose Your Generation Mode
+
+#### Mode A — Without Reference Images
+
+Use this when you only have a text idea, game design brief, or art direction.
+
+Example prompt:
+
+```text
+Read skills/pixel-asset-master/SKILL.md.
+Create a 64x64 4-direction RPG character sprite sheet.
+Style: ink-wash gongbi pixel art.
+Actions: idle and walk.
+No reference image.
+```
+
+The agent should:
+
+1. Confirm style, size, palette, facing direction, action list, and frame count.
+2. Create or update `projects/<project_name>/design_spec.md`.
+3. Create or update `projects/<project_name>/spec_lock.md`.
+4. Generate PNG assets, animation frames, sprite sheets, and manifests.
+
+#### Mode B — With Reference Images
+
+Use this when you already have character art, tiles, UI mockups, moodboards, or screenshots that should guide the generated pixel art.
+
+First, import reference images:
+
+```bash
+pam import-sources projects/demo_32x32_YYYYMMDD path/to/reference.png
+```
+
+Then prompt the AI agent:
+
+```text
+Read skills/pixel-asset-master/SKILL.md.
+Use the images under projects/demo_32x32_YYYYMMDD/images/ as visual references.
+Generate matching pixel art assets and keep the same silhouette, palette mood, and style constraints.
+```
+
+The agent should analyze the reference images, derive style and palette constraints, then continue through the same spec lock, generation, validation, and export pipeline.
+
+### 6. Validate and Export
+
+```bash
+pam validate-project projects/demo_32x32_YYYYMMDD
+pam validate-assets projects/demo_32x32_YYYYMMDD
+pam finalize projects/demo_32x32_YYYYMMDD --all
+pam sheet projects/demo_32x32_YYYYMMDD --by-category
+```
+
+> **AI lost context?** Ask it to read `skills/pixel-asset-master/SKILL.md`.
+
+---
+
+## Repository Layout
+
+```text
+.
+├── pyproject.toml
+├── uv.lock
+├── src/
+│   └── pixel_asset_master/      # Installable Python package / CLI
+├── skills/
+│   └── pixel-asset-master/
+│       ├── SKILL.md
+│       ├── references/
+│       ├── scripts/
+│       │   └── README.md        # CLI command reference
+│       ├── templates/
+│       └── workflows/
+└── projects/                    # Generated asset projects (ignored by Git)
+```
+
+## Documentation
+
+| | Document | Description |
+|---|----------|-------------|
+| 📖 | [SKILL.md](./skills/pixel-asset-master/SKILL.md) | Core workflow and execution rules |
+| 🛠️ | [CLI Reference](./skills/pixel-asset-master/scripts/README.md) | `pam` command usage and examples |
+| 🏗️ | [Project Structure](./docs/PROJECT_STRUCTURE.md) | Repository structure and generated-content boundaries |
+| 🤝 | [Contributing](./CONTRIBUTING.md) | Contribution scope and workflow |
+| 🔐 | [Security](./SECURITY.md) | Vulnerability reporting and scope |
+
+## What Should Not Be Committed
+
+- **Generated projects**: `projects/`
+- **Export packages**: `exports/`, `*.zip`, `*.tar.gz`
+- **Secrets**: `.env`, real API keys, tokens, private account data
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for how to get involved.
+
+## License
+
+[MIT](LICENSE)
+
+[⬆ Back to Top](#pixel-asset-master--ai-generates-2d-pixel-game-assets-from-game-design-briefs)

pixel_asset_master-0.1.0/README.md

@@ -0,0 +1,190 @@
+# Pixel Asset Master — AI generates 2D pixel game assets from game design briefs
+
+[![Version](https://img.shields.io/badge/version-v0.1.0-blue.svg)](#)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python](https://img.shields.io/badge/Python-3.8%2B-3776AB.svg)](https://www.python.org/)
+
+English | [中文](./README_CN.md)
+
+Drop in a game concept, art direction, or reference images — get back a structured pixel asset project with sprites, tiles, items, UI, effects, backgrounds, animation frames, sprite sheets, and export metadata.
+
+我是一名对游戏独立开发感兴趣的大学生，这个项目的灵感来自 PPT-master。它尝试把“用结构化流程辅助创作”的思路迁移到 2D 游戏像素素材生成中，让独立开发者可以更快整理美术方向、生成素材，并保留可复用的项目规范。
+
+## Project Example
+
+下面是一个水墨工笔像素风项目示例，包含两种树与竹子的动画展示。
+
+| Asset | Preview | Frames |
+|-------|---------|--------|
+| Cherry Blossom Tree | ![Cherry Blossom Tree Animation](./sakura_preview.gif) | 6-frame sprite sheet |
+| Willow Tree | ![Willow Tree Animation](./tree_willow_preview.gif) | 6-frame sprite sheet |
+| Bamboo | ![Bamboo Animation](./bamboo_preview.gif) | 4-frame sprite sheet |
+
+> **How it works** — Pixel Asset Master is a workflow skill for AI IDEs. You chat with an AI agent, confirm the style constraints, and the skill guides the agent through project setup, asset planning, generation, validation, and export.
+
+> **Local-first workflow** — Project files and generated assets are stored locally under `projects/`. API usage only depends on whatever AI tool or image provider you choose to connect.
+
+Pixel Asset Master focuses on:
+
+- **Game-ready structure** — assets are grouped by `characters`, `tiles`, `items`, `ui`, `effects`, and `backgrounds`.
+- **Strict visual contract** — `spec_lock.md` records canvas size, palette, style, color budget, and forbidden rendering patterns.
+- **Reusable templates** — built-in palettes, size presets, and sprite layout references.
+- **Validation tools** — scripts help check palette compliance, color budget, image format, and sprite sheet export.
+- **Agent-friendly process** — staged confirmations reduce vague prompts and keep long asset runs consistent.
+
+---
+
+## Quick Start
+
+### 1. Prerequisites
+
+| Dependency | Required? | What it does |
+|------------|:---------:|--------------|
+| Python 3.8+ | ✅ Yes | Runs the helper scripts |
+| Pillow | ✅ Yes | Image analysis, validation, quantization, and sprite sheet packing |
+
+Install the CLI tool with [uv](https://docs.astral.sh/uv/):
+
+```bash
+uv tool install .
+```
+
+This installs the `pam` (and `pixel-asset-master`) command globally. If you prefer to run without installing, use `uv run pam ...` from the repository root.
+
+### 2. Set Up
+
+**Option A — Download ZIP**: download the repository ZIP from GitHub and unzip it.
+
+**Option B — Git clone**:
+
+```bash
+git clone <your-repository-url>
+cd pixel-asset-master-skills
+uv tool install .
+```
+
+### 3. Put It Into Your AI Coding IDE
+
+After downloading or unzipping the repository, open the **entire `pixel-asset-master-skills/` folder** as a workspace in your AI coding IDE.
+
+| IDE | How to use |
+|-----|------------|
+| **Cursor** | `File → Open Folder...` and select `pixel-asset-master-skills/`. Ask the chat agent to read `skills/pixel-asset-master/SKILL.md`. |
+| **Trae** | Open the folder as a project/workspace. Then mention `skills/pixel-asset-master/SKILL.md` in chat before asking for assets. |
+| **Windsurf** | Open the folder in Windsurf. Use Cascade chat and reference `skills/pixel-asset-master/SKILL.md` when starting a pixel asset task. |
+| **Other AI coding IDEs** | Open the repository root as the workspace and point the agent to `skills/pixel-asset-master/SKILL.md`. |
+
+Recommended first prompt:
+
+```text
+Read skills/pixel-asset-master/SKILL.md and help me create a pixel art asset project.
+```
+
+### 4. Create a Pixel Asset Project
+
+```bash
+pam init demo --size 32x32 --palette DB32
+```
+
+The generated project is saved under `projects/` and is ignored by Git by default.
+
+### 5. Choose Your Generation Mode
+
+#### Mode A — Without Reference Images
+
+Use this when you only have a text idea, game design brief, or art direction.
+
+Example prompt:
+
+```text
+Read skills/pixel-asset-master/SKILL.md.
+Create a 64x64 4-direction RPG character sprite sheet.
+Style: ink-wash gongbi pixel art.
+Actions: idle and walk.
+No reference image.
+```
+
+The agent should:
+
+1. Confirm style, size, palette, facing direction, action list, and frame count.
+2. Create or update `projects/<project_name>/design_spec.md`.
+3. Create or update `projects/<project_name>/spec_lock.md`.
+4. Generate PNG assets, animation frames, sprite sheets, and manifests.
+
+#### Mode B — With Reference Images
+
+Use this when you already have character art, tiles, UI mockups, moodboards, or screenshots that should guide the generated pixel art.
+
+First, import reference images:
+
+```bash
+pam import-sources projects/demo_32x32_YYYYMMDD path/to/reference.png
+```
+
+Then prompt the AI agent:
+
+```text
+Read skills/pixel-asset-master/SKILL.md.
+Use the images under projects/demo_32x32_YYYYMMDD/images/ as visual references.
+Generate matching pixel art assets and keep the same silhouette, palette mood, and style constraints.
+```
+
+The agent should analyze the reference images, derive style and palette constraints, then continue through the same spec lock, generation, validation, and export pipeline.
+
+### 6. Validate and Export
+
+```bash
+pam validate-project projects/demo_32x32_YYYYMMDD
+pam validate-assets projects/demo_32x32_YYYYMMDD
+pam finalize projects/demo_32x32_YYYYMMDD --all
+pam sheet projects/demo_32x32_YYYYMMDD --by-category
+```
+
+> **AI lost context?** Ask it to read `skills/pixel-asset-master/SKILL.md`.
+
+---
+
+## Repository Layout
+
+```text
+.
+├── pyproject.toml
+├── uv.lock
+├── src/
+│   └── pixel_asset_master/      # Installable Python package / CLI
+├── skills/
+│   └── pixel-asset-master/
+│       ├── SKILL.md
+│       ├── references/
+│       ├── scripts/
+│       │   └── README.md        # CLI command reference
+│       ├── templates/
+│       └── workflows/
+└── projects/                    # Generated asset projects (ignored by Git)
+```
+
+## Documentation
+
+| | Document | Description |
+|---|----------|-------------|
+| 📖 | [SKILL.md](./skills/pixel-asset-master/SKILL.md) | Core workflow and execution rules |
+| 🛠️ | [CLI Reference](./skills/pixel-asset-master/scripts/README.md) | `pam` command usage and examples |
+| 🏗️ | [Project Structure](./docs/PROJECT_STRUCTURE.md) | Repository structure and generated-content boundaries |
+| 🤝 | [Contributing](./CONTRIBUTING.md) | Contribution scope and workflow |
+| 🔐 | [Security](./SECURITY.md) | Vulnerability reporting and scope |
+
+## What Should Not Be Committed
+
+- **Generated projects**: `projects/`
+- **Export packages**: `exports/`, `*.zip`, `*.tar.gz`
+- **Secrets**: `.env`, real API keys, tokens, private account data
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for how to get involved.
+
+## License
+
+[MIT](LICENSE)
+
+[⬆ Back to Top](#pixel-asset-master--ai-generates-2d-pixel-game-assets-from-game-design-briefs)

pixel_asset_master-0.1.0/pyproject.toml

@@ -0,0 +1,26 @@
+[project]
+name = "pixel-asset-master"
+version = "0.1.0"
+description = "AI-driven 2D pixel game asset generation toolkit"
+readme = "README.md"
+requires-python = ">=3.8"
+dependencies = [
+    "Pillow>=10.0.0",
+]
+
+[project.scripts]
+pam = "pixel_asset_master.cli:main"
+pixel-asset-master = "pixel_asset_master.cli:main"
+
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+pixel_asset_master = ["skills/pam/**/*"]
+
+[tool.uv]
+package = true

pixel_asset_master-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pixel_asset_master-0.1.0/src/pixel_asset_master/__init__.py

@@ -0,0 +1,3 @@
+"""Pixel Asset Master — AI-driven 2D pixel game asset toolkit."""
+
+__version__ = "0.1.0"

pixel_asset_master-0.1.0/src/pixel_asset_master/cli.py

@@ -0,0 +1,164 @@
+"""Unified CLI entry point for Pixel Asset Master."""
+
+import argparse
+import sys
+
+from pixel_asset_master import __version__
+from pixel_asset_master.common import resolve_root
+from pixel_asset_master.finalize import cmd_clean, cmd_index, cmd_quantize
+from pixel_asset_master.install_skill import cmd_install_skills
+from pixel_asset_master.palette import cmd_distance, cmd_extract, cmd_validate as cmd_validate_palette
+from pixel_asset_master.project import cmd_import_sources, cmd_init, cmd_validate_project
+from pixel_asset_master.sheet import cmd_sheet
+from pixel_asset_master.validate import cmd_validate_assets
+
+
+def _add_root_argument(parser: argparse.ArgumentParser) -> None:
+    parser.add_argument(
+        "--root",
+        default=None,
+        help="Workspace root directory (default: current directory; override with PAM_PROJECTS_ROOT env var)",
+    )
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(
+        prog="pam",
+        description="Pixel Asset Master — AI-driven 2D pixel game asset toolkit",
+    )
+    parser.add_argument(
+        "--version", action="version", version=f"%(prog)s {__version__}"
+    )
+    _add_root_argument(parser)
+
+    sub = parser.add_subparsers(dest="command", help="Available commands")
+
+    # ── init ───────────────────────────────────────────────────────────────
+    p_init = sub.add_parser("init", help="Initialize a new project")
+    p_init.add_argument("project_name", help="Project name")
+    p_init.add_argument("--size", default="32x32", help="Base sprite size (e.g. 32x32)")
+    p_init.add_argument("--palette", default="DB32", help="Palette name (resolved from workspace palettes_index.json if available)")
+    p_init.add_argument("--palette-file", default=None, help="Path to a JSON palette file")
+    p_init.add_argument("--palette-colors", default=None, help="Comma-separated hex colors (e.g. '#FF0000,#00FF00')")
+
+    # ── import-sources ─────────────────────────────────────────────────────
+    p_import = sub.add_parser("import-sources", help="Import reference images into a project")
+    p_import.add_argument("project_path", help="Project directory path")
+    p_import.add_argument("files", nargs="+", help="Files to import")
+    p_import.add_argument("--move", action="store_true", help="Move instead of copy")
+
+    # ── validate-project ───────────────────────────────────────────────────
+    p_validate = sub.add_parser("validate-project", help="Validate project structure")
+    p_validate.add_argument("project_path", help="Project directory path")
+
+    # ── validate-assets ────────────────────────────────────────────────────
+    p_validate_assets = sub.add_parser("validate-assets", help="Validate pixel art assets against spec_lock")
+    p_validate_assets.add_argument("project_path", help="Project directory path")
+
+    # ── palette ────────────────────────────────────────────────────────────
+    p_palette = sub.add_parser("palette", help="Palette extraction and validation")
+    pal_sub = p_palette.add_subparsers(dest="palette_command", help="Palette commands")
+
+    p_pal_extract = pal_sub.add_parser("extract", help="Extract palette from image")
+    p_pal_extract.add_argument("image_path", help="Path to reference image")
+    p_pal_extract.add_argument("--count", type=int, default=16, help="Number of colors")
+
+    p_pal_validate = pal_sub.add_parser("validate", help="Validate assets against project palette")
+    p_pal_validate.add_argument("project_path", help="Project directory path")
+
+    p_pal_distance = pal_sub.add_parser("distance", help="Distance between two colors")
+    p_pal_distance.add_argument("color1", help="First color (#RRGGBB)")
+    p_pal_distance.add_argument("color2", help="Second color (#RRGGBB)")
+
+    # ── finalize ───────────────────────────────────────────────────────────
+    p_finalize = sub.add_parser("finalize", help="Post-process pixel art assets")
+    p_finalize.add_argument("project_path", help="Project directory path")
+    p_finalize.add_argument("--quantize", action="store_true", help="Quantize to declared palette")
+    p_finalize.add_argument("--clean", action="store_true", help="Remove stray isolated pixels")
+    p_finalize.add_argument("--index", action="store_true", help="Convert to indexed PNG")
+    p_finalize.add_argument("--all", action="store_true", help="Run all steps")
+
+    # ── sheet ──────────────────────────────────────────────────────────────
+    p_sheet = sub.add_parser("sheet", help="Pack sprite sheets")
+    p_sheet.add_argument("project_path", help="Project directory path")
+    p_sheet.add_argument("--by-category", action="store_true", default=True, help="Pack by category/animation")
+
+    # ── install-skills ─────────────────────────────────────────────────────
+    p_install = sub.add_parser("install-skills", help="Install the bundled pam Agent Skill")
+    p_install.add_argument("--target", default=None, help="Destination directory (default: ~/.agents/skills/pam)")
+    p_install.add_argument("--dry-run", action="store_true", help="Print what would be installed without copying")
+
+    args = parser.parse_args(argv)
+
+    if args.command is None:
+        parser.print_help()
+        return 1
+
+    # Resolve root for commands that need it. Most commands use explicit project_path.
+    _ = resolve_root(args.root)
+
+    if args.command == "init":
+        palette_colors = None
+        if args.palette_colors:
+            palette_colors = [c.strip() for c in args.palette_colors.split(",")]
+        cmd_init(
+            args.project_name,
+            args.size,
+            args.palette,
+            palette_file=args.palette_file,
+            palette_colors=palette_colors,
+            root=args.root,
+        )
+        return 0
+
+    if args.command == "import-sources":
+        cmd_import_sources(args.project_path, args.files, move=args.move)
+        return 0
+
+    if args.command == "validate-project":
+        ok = cmd_validate_project(args.project_path)
+        return 0 if ok else 1
+
+    if args.command == "validate-assets":
+        ok = cmd_validate_assets(args.project_path)
+        return 0 if ok else 1
+
+    if args.command == "palette":
+        if args.palette_command == "extract":
+            cmd_extract(args.image_path, count=args.count)
+            return 0
+        if args.palette_command == "validate":
+            cmd_validate_palette(args.project_path)
+            return 0
+        if args.palette_command == "distance":
+            cmd_distance(args.color1, args.color2)
+            return 0
+        p_palette.print_help()
+        return 1
+
+    if args.command == "finalize":
+        if args.all or args.quantize:
+            cmd_quantize(args.project_path)
+        if args.all or args.clean:
+            cmd_clean(args.project_path)
+        if args.all or args.index:
+            cmd_index(args.project_path)
+        if not (args.quantize or args.clean or args.index or args.all):
+            p_finalize.print_help()
+            return 1
+        return 0
+
+    if args.command == "sheet":
+        cmd_sheet(args.project_path, by_category=args.by_category)
+        return 0
+
+    if args.command == "install-skills":
+        ok = cmd_install_skills(target=args.target, dry_run=args.dry_run)
+        return 0 if ok else 1
+
+    parser.print_help()
+    return 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())