Packaging Python

VérifiéSûr

Guide complet pour créer, structurer et distribuer des paquets Python avec les outils modernes (pyproject.toml, PyPI).

Spar Skills Guide Bot
DeveloppementIntermédiaire
28/07/2026
Claude CodeCursorWindsurfCopilotCodex
#python#packaging#pyproject#pypi#distribution

Recommandé pour

Synthèse automatique

Ce skill guide la création, la structuration et la publication de paquets Python modernes avec pyproject.toml, y compris la distribution vers PyPI ou un dépôt privé.

Points forts

  • Couvre le cycle complet : structure du projet, métadonnées, dépendances, wheels/sdist, versioning et release
  • Cible explicitement les outils modernes (pyproject.toml) plutôt que les setups historiques type setup.py
  • Inclut les points d'entrée CLI, les namespace packages et la publication sur dépôts privés
  • S'appuie sur un playbook d'implémentation détaillé dans resources/ pour les cas concrets

Limites

  • Le contenu fourni reste générique : les instructions précises vivent dans resources/implementation-playbook.md, absent ici
  • Aucune validation automatique des builds ou des uploads, la vérification en environnement réel reste à la charge de l'utilisateur
  • Ne traite pas des outils de build alternatifs ni des cas mono-repo complexes au-delà de ce qui est listé
Quand l'utiliser

À utiliser dès qu'il s'agit de transformer du code Python en paquet installable, configurer un pyproject.toml ou publier une version sur PyPI ou un index privé.

Quand l'éviter

À éviter pour des tâches hors packaging Python, comme du refactoring applicatif, du déploiement d'infrastructure ou de la configuration d'environnements virtuels au quotidien.

Analyse de sécurité

Sûr
Score qualité72/100

The skill is a documentation/guide about Python packaging with no declared tools, no destructive commands, no network exfiltration, and no obfuscated or unsafe instructions. It does not execute anything itself.

Aucun point d'attention détecté

Comment cette analyse est faite

Exemples

Publish a library to PyPI
I wrote a small utility library and want to publish it to PyPI. Help me write the pyproject.toml, set up the src layout, build the wheel and sdist, and walk me through the upload steps.
Add a CLI entry point
Turn my existing Python module into an installable package that exposes a `mytool` command via an entry point, and show me how to test it after a local pip install.
Private index release
Set up my Python package for distribution to a private package index instead of PyPI, including versioning and metadata classifiers.

name: python-packaging description: "Comprehensive guide to creating, structuring, and distributing Python packages using modern packaging tools, pyproject.toml, and publishing to PyPI." risk: safe source: community date_added: "2026-02-27"

Python Packaging

Comprehensive guide to creating, structuring, and distributing Python packages using modern packaging tools, pyproject.toml, and publishing to PyPI.

Use this skill when

  • Creating Python libraries for distribution
  • Building command-line tools with entry points
  • Publishing packages to PyPI or private repositories
  • Setting up Python project structure
  • Creating installable packages with dependencies
  • Building wheels and source distributions
  • Versioning and releasing Python packages
  • Creating namespace packages
  • Implementing package metadata and classifiers

Do not use this skill when

  • The task is unrelated to python packaging
  • You need a different domain or tool outside this scope

Instructions

  • Clarify goals, constraints, and required inputs.
  • Apply relevant best practices and validate outcomes.
  • Provide actionable steps and verification.
  • If detailed examples are required, open resources/implementation-playbook.md.

Resources

  • resources/implementation-playbook.md for detailed patterns and examples.

Limitations

  • Use this skill only when the task clearly matches the scope described above.
  • Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
  • Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

Du fichier au premier essai

Le téléchargement contient exactement le contenu affiché sur cette fiche. Cette copie peut différer de la dernière version du dépôt source.

Consulter la source et ses fichiers annexes

Ce téléchargement contient uniquement SKILL.md. Les scripts, références, modèles et dépendances éventuels ne sont pas inclus. Récupérez les fichiers nécessaires depuis la source en conservant leur arborescence avant de poursuivre.

1. Télécharger le fichier

Télécharger SKILL.md

Depuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/python-packaging-ms47vpvo/SKILL.md, ou utilisez la commande suivante. Ce dossier sert à examiner la skill avant son installation.

Commande pour macOS/Linux ou WSL : un shell POSIX et curl sont nécessaires. Sous Windows sans WSL, utilisez le bouton de téléchargement et créez le dossier manuellement.

mkdir -p '.skill-downloads/python-packaging-ms47vpvo' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/python-packaging-ms47vpvo/download' --output '.skill-downloads/python-packaging-ms47vpvo/SKILL.md.part' && mv '.skill-downloads/python-packaging-ms47vpvo/SKILL.md.part' '.skill-downloads/python-packaging-ms47vpvo/SKILL.md'

2. Vérifier les prérequis

Lisez SKILL.md avant de l’utiliser. Si le fichier cite des scripts ou services externes, examinez-les et préparez les accès nécessaires dans votre environnement de test.

Aucune section de prérequis reconnue dans ce fichier. Cela ne signifie pas qu’il est autonome : les bibliothèques, outils et accès peuvent être cités ailleurs dans le contenu ou dans le dépôt source.

Les plateformes de la fiche sont des indications du catalogue. Les chemins ci-dessous suivent la documentation des outils ; ils ne prouvent pas que cette skill y a été exécutée. Aucune version minimale de ces outils n’est attestée pour cette fiche.

3. Charger la skill

Après vérification, copiez le dossier complet dans le projet avec l’une des commandes ci-dessous, puis ouvrez une nouvelle session de l’outil. La commande s’arrête si un dossier du même nom existe déjà : comparez les fichiers avant de le remplacer.

Claude Code
test -f '.skill-downloads/python-packaging-ms47vpvo/SKILL.md' && test -s '.skill-downloads/python-packaging-ms47vpvo/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/python-packaging' && cp -R '.skill-downloads/python-packaging-ms47vpvo' '.claude/skills/python-packaging'

Cursor
test -f '.skill-downloads/python-packaging-ms47vpvo/SKILL.md' && test -s '.skill-downloads/python-packaging-ms47vpvo/SKILL.md' && mkdir -p '.cursor/skills' && test ! -e '.cursor/skills/python-packaging' && cp -R '.skill-downloads/python-packaging-ms47vpvo' '.cursor/skills/python-packaging'

Codex
test -f '.skill-downloads/python-packaging-ms47vpvo/SKILL.md' && test -s '.skill-downloads/python-packaging-ms47vpvo/SKILL.md' && mkdir -p '.agents/skills' && test ! -e '.agents/skills/python-packaging' && cp -R '.skill-downloads/python-packaging-ms47vpvo' '.agents/skills/python-packaging'

OpenSkills

OpenSkills doit déjà être installé. La procédure locale install/read est contrôlée avec OpenSkills 1.5.0, qui exige Node.js ≥ 20.6.0. Aucun slug du catalogue n’est résolu automatiquement.

Installation officielle d’OpenSkills
openskills install './.skill-downloads/python-packaging-ms47vpvo'

openskills read 'python-packaging-ms47vpvo'

La lecture doit afficher le contenu du fichier installé et son dossier de base. Elle ne lance ni la skill ni ses dépendances.

Pour un agent qui lit AGENTS.md, synchronisez ensuite l’index. Cette commande modifie AGENTS.md : relisez le diff avant de l’utiliser.

openskills sync

Mode manuel ou autre outil : joignez SKILL.md à une conversation, ou ouvrez-le dans un agent capable de lire les fichiers. Ajoutez les ressources annexes nécessaires. Il n’existe pas de dossier universel reconnu par tous les outils.

4. Faire un premier essai

Utilisez une entrée courte et fictive : un endpoint d’API, un petit document ou un brief d’interface. Dans une nouvelle conversation, joignez le fichier ou donnez son chemin à l’agent, puis adaptez cette demande :

Lis .skill-downloads/python-packaging-ms47vpvo/SKILL.md et applique ses instructions à cet exemple : [décrire une entrée de test]. Indique les fichiers, dépendances ou accès qui manquent. Produis le résultat demandé par la skill sans inventer de données ni exécuter de script non examiné.

Résultat attendu : une sortie correspondant aux instructions de la skill, ou une liste précise des prérequis manquants. Une simple confirmation de lecture ne valide pas le premier usage. Si une ressource externe est indisponible, ce parcours reste à tester.

Skills similaires