Python Packaging

What it does

When your agent uses it

• Development work in your project

Example prompts

• “/python-packaging”

Requirements

• Python 3

Workflow steps

4 steps, taken from the step headings in SKILL.md.

1. 1Modern Build Systems
2. 2Build Backend: Hatchling
3. 3Package Structure
4. 4Scientific Python Standards

What it can do on your machine

Read from SKILL.md and the folder at commit 3cdd0ee. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 1 file in scripts/ (Python), which the agent can run.

  Shell commands in SKILL.md call:

  • pip
  • python

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Hosts in commands or code, which the agent is likely to contact:

  • test.pypi.org

  Also links to:

  • learn.scientific-python.org
  • packaging.python.org
  • pypi.org
  • hatch.pypa.io
  • pypa-build.readthedocs.io
  • twine.readthedocs.io
  • github.com
  • numpydoc.readthedocs.io

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Python Packaging loads about 2.3k tokens when it runs, and up to ~5.5k if it reads all its reference files. Until then it costs about 56 tokens; SKILL.md has 688 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~56

When it runs · the whole SKILL.md, loaded when a task matches

~2.3k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~5.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from Yikai-Liao/symusic at commit 3cdd0ee, republished under its MIT licence (© Yikai-Liao). 688 words, ~2,328 tokens.

name

python-packaging

description

Create and publish distributable scientific Python packages following Scientific Python community best practices. Covers pyproject.toml, src layout, Hatchling, metadata, CLI entry points, and PyPI publishing.

metadata.assets

assets/pyproject-minimal.toml, assets/pyproject-full-featured.toml, assets/readme-template.md, assets/github-actions-publish.yml, assets/sphinx-conf.py…

metadata.references

references/common-issues.md, references/docstrings.md, references/metadata.md, references/patterns.md

metadata.scripts

scripts/cli-example.py

START
  ├─ Pure Python scientific package (most common) → Pattern 1 (src/ layout)
  ├─ Need data files with package → Pattern 2 (data/ subdirectory)
  ├─ CLI tool → Pattern 5 (add [project.scripts])
  └─ Complex multi-feature package → Pattern 3 (full-featured)

START → Use Hatchling (recommended for scientific Python)
  ├─ Need VCS versioning? → Add hatch-vcs plugin
  ├─ Simple manual versioning? → version = "X.Y.Z" in pyproject.toml
  └─ Dynamic from __init__.py? → [tool.hatch.version] path

START
  ├─ Runtime dependencies → [project] dependencies
  ├─ Optional features → [project.optional-dependencies]
  ├─ Development tools → [dependency-groups] (PEP 735)
  └─ Version constraints → Use >= for minimum, avoid upper caps

1. Build: python -m build
2. Check: twine check dist/*
3. Test: twine upload --repository testpypi dist/*
4. Verify: pip install --index-url https://test.pypi.org/simple/ pkg
5. Publish: twine upload dist/*

# Setup new package
mkdir -p my-pkg/src/my_pkg && cd my-pkg
# Create pyproject.toml with [build-system] and [project] sections

# Development install
pip install -e . --group dev

# Build distributions
python -m build

# Test installation
pip install dist/*.whl

# Publish
twine upload dist/*

my-sci-package/
├── pyproject.toml
├── README.md
├── LICENSE
├── src/
│   └── my_sci_package/
│       ├── __init__.py
│       ├── analysis.py
│       └── utils.py
├── tests/
│   ├── test_analysis.py
│   └── test_utils.py
└── docs/
    └── index.md

[project.scripts]
sci-analyze = "my_sci_package.cli:main"

© Yikai-Liao, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 11 other files (scripts, references, assets) in .agents/skills/python-packaging of Yikai-Liao/symusic.

• SKILL.md
• assets/.gitignore
• assets/github-actions-publish.yml
• assets/pyproject-full-featured.toml
• assets/pyproject-minimal.toml
• assets/readme-template.md
• assets/sphinx-conf.py
• references/common-issues.md
• references/docstrings.md
• references/metadata.md
• references/patterns.md
• scripts/cli-example.py

Open the folder on GitHubat commit 3cdd0ee