---
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:22.211904+00:00"
---

# 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.