---
id: 002fc433-6969-4f1d-b400-50b8324bb82d
type: configuration
title: "z-image restructured as proper Python package with uv tool install"
tags: [z-image, python, uv, cli-tools, configuration, claude-code-config, skills]
importance: 0.65
confidence: 0.8
created: "2026-03-01T05:48:22.211904+00:00"
updated: "2026-03-01T05:48:51.898741+00:00"
relations:
  - target: e0a851a7-1dc5-4191-b220-aa90112a1171
    type: CAUSES
    direction: incoming
    strength: 0.9
    edge_id: f8920f75-7809-4b4a-ae30-77bd85c28ef1
  - target: a41644f1-2dd1-4706-8fc8-e2242c1702cb
    type: FOLLOWS
    direction: outgoing
    strength: 0.85
    edge_id: bd5850a8-2974-47b8-987e-bc8966b08c5f
---

# z-image Restructured as Proper Python Package

## Before
- Location: `~/.claude/skills/z-image/` (embedded in skills directory)
- Had embedded venv and `generate.py` directly in the skills folder
- Bash wrapper at `~/bin/z-image`

## After
- App location: `/mnt/NV2/Development/z-image/`
- Structure: proper Python package with `pyproject.toml` and `src/` layout
  - `src/z_image/cli.py` — main CLI entry point
- Installation: `uv tool install -e .` (editable install)
- Binary location: `~/.local/bin/z-image` (from console_scripts entry point)
- Skills location: only `SKILL.md` remains in `~/.claude/skills/z-image/`

## Changes Made
- Removed old bash wrapper at `~/bin/z-image`
- Removed embedded venv from skills directory
- Created `pyproject.toml` with `console_scripts` entry point
- Moved source into `src/z_image/` layout

## Pattern Applied
Skills should only contain `SKILL.md` instructions. Application code lives in proper development location and is referenced by CLI command name, not path.