# Simple Modern Uv

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-jlevy-simple-modern-uv-simple-modern-uv`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [jlevy](https://agentstack.voostack.com/s/jlevy)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [jlevy](https://github.com/jlevy)
- **Source:** https://github.com/jlevy/simple-modern-uv/tree/main/skills/simple-modern-uv
- **Website:** https://github.com/jlevy/simple-modern-uv-template

## Install

```sh
agentstack add skill-jlevy-simple-modern-uv-simple-modern-uv
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# simple-modern-uv: Modern Python Project Setup

[simple-modern-uv](https://github.com/jlevy/simple-modern-uv) is a minimal, modern
Python project template: **uv** for everything package-related, **ruff** for
lint/format, **BasedPyright** for type checking, **pytest**, GitHub Actions CI, and
tag-driven publishing to PyPI with dynamic versioning (the git tag is the version).
It is a [Copier](https://copier.readthedocs.io) template, so projects can pull future
template improvements at any time with `copier update`.

There are three workflows.
Pick by situation:

1. **New project**: create a project from scratch.
2. **Upgrade existing project**: convert any existing Python package to this template’s
   structure and tooling.
   See [references/adopt-existing.md](references/adopt-existing.md).
3. **Update templated project**: the project has a `.copier-answers.yml` from this
   template; pull the latest template changes.

For all workflows: when something fails, check [references/faq.md](references/faq.md)
before improvising. For post-setup customization (license change, private/unpublished
package, entry points), see [references/customize.md](references/customize.md).

If this file was fetched from a URL rather than installed as a folder, fetch the
reference files from the **same ref**: replace `SKILL.md` in the URL you used with
`references/.md` (don’t mix a pinned `SKILL.md` with references from `main`).

## The Interview: What to Ask the User (and What Not to Ask)

Every workflow uses the same answer set (the template’s questions in
[copier.yml](https://github.com/jlevy/simple-modern-uv/blob/main/copier.yml)). **Infer
everything you can, then ask the user to confirm once, in a single batched message.**
Never ask one question at a time, and never ask about things listed under “conventions”
below.

**Essentials** (confirm these; they are the user’s decisions):

| Answer key | Meaning | Notes |
| --- | --- | --- |
| `package_name` | PyPI package and GitHub repo name | Normalize to **kebab-case** (`acme-widgets`); show the user the name you derived |
| `package_module` | Python module name | Derived automatically as **snake_case** (`acme_widgets`); show it, don’t ask |
| `package_description` | One-line description |  |
| `package_license` | `MIT` (default), `Apache-2.0`, `BSD-3-Clause`, `AGPL-3.0-or-later`, `Proprietary`, or `None` (decide later) | Always surface, naming the default |
| `publish_to_pypi` | `true` (default) or `false` | Always surface; `false` for private packages and apps |

For `package_author_name`, `package_author_email`, and `package_github_org`, **infer**
values from `git config user.name` and `user.email` and the repo’s remote or
`gh auth status`, and include them in the confirmation summary rather than asking.

**Conventions** (apply silently; mention in your final summary; deviate only if the user
explicitly asks): `src/` layout; first version is the git tag `v0.1.0` for a new project
(for upgrades of published packages, the next version above what’s on PyPI); Python
3.11+; line length 100; the template’s tool choices.
These are never questions.

## Workflow 1: New Project

1. Run the interview (above).
   Then render, replacing the answer values:

   ```bash
   uvx copier@9.15.1 copy --defaults \
     --data package_name=acme-widgets \
     --data "package_description=One-line description" \
     --data "package_author_name=Jane Doe" \
     --data package_author_email=jane@example.com \
     --data package_github_org=acme \
     --data package_license=MIT \
     --data publish_to_pypi=true \
     gh:jlevy/simple-modern-uv acme-widgets
   ```

   (Omit `--data` keys that should take defaults.
   `package_module` derives automatically from `package_name`.)

2. Initialize git, commit, then install.
   Sync only after the first commit: dynamic versioning reads git, and syncing first
   leaves the editable install’s version at `0.0.0`.

   ```bash
   cd acme-widgets
   git init --initial-branch=main
   git add . && git commit -m "Initial commit from simple-modern-uv."
   uv sync --all-extras
   git add uv.lock && git commit -m "Add uv.lock."
   ```

3. **Verify**: `make lint` and `make test` must pass.
   Fix anything that doesn’t before declaring success.

4. Offer next steps (don’t just stop): create the GitHub repo and push (an empty repo
   with no README, license, or .gitignore; the template provides them); fill in
   `README.md`; if publishing, `docs/publishing.md` covers the one-time PyPI Trusted
   Publisher setup; tag `v0.1.0` when ready to release.

## Workflow 2: Upgrade an Existing Project

Follow [references/adopt-existing.md](references/adopt-existing.md).
In brief: run the interview with answers **inferred from the repo itself**
(pyproject/setup.py metadata, LICENSE file, git remote, PyPI presence), render the
template into a sibling temp directory with those answers, merge the template’s
structure into the project (preserving its dependencies, metadata, and code), translate
old tool configs to uv equivalents, write `.copier-answers.yml` so future updates work,
and verify with `uv sync`, lint, and tests.
Land everything on a branch as one reviewable change.

## Workflow 3: Update a Templated Project

Requires a clean working tree and the project’s `.copier-answers.yml`.

1. If the template has questions the project has never answered (keys present in the
   template’s `copier.yml` but missing from the project’s `.copier-answers.yml`), first
   check the project’s actual state and pass matching `--data` so defaults can’t revert
   hand customizations (see “Reconciling New Questions on Update” in
   [references/customize.md](references/customize.md)).

2. ```bash
   uvx copier@9.15.1 update --defaults --skip-answered
   ```

3. Resolve any `*.rej` files or inline conflict markers, re-run `make lint` and
   `make test`, then summarize what the template update changed (check the
   [release notes](https://github.com/jlevy/simple-modern-uv/releases)).

## Verification Gate (All Workflows)

Before reporting success: `uv sync --all-extras`, `make lint`, and `make test` all pass,
and for publishable packages `uv build` produces a wheel with a sensible version
(requires at least one git commit; see the FAQ if the version looks wrong).
Report what you ran and the results.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [jlevy](https://github.com/jlevy)
- **Source:** [jlevy/simple-modern-uv](https://github.com/jlevy/simple-modern-uv)
- **License:** MIT
- **Homepage:** https://github.com/jlevy/simple-modern-uv-template

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-jlevy-simple-modern-uv-simple-modern-uv
- Seller: https://agentstack.voostack.com/s/jlevy
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.