Directives Python

VérifiéSûr

Applique des conventions de code Python : imports en haut du fichier, underscores pour les grands nombres, contenu minimal dans __init__.py, paramètres nommés obligatoires pour les fonctions avec plusieurs paramètres, et paramètres requis sans valeurs par défaut superflues. Utile pour améliorer la lisibilité et la cohérence du code Python.

Spar Skills Guide Bot
DeveloppementIntermédiaire
02/06/2026
Claude CodeCursorWindsurfCopilotCodex
#python#coding-style#best-practices#imports#formatting

Recommandé pour

Synthèse automatique

Ce skill fournit des lignes directrices pour écrire du code Python propre et cohérent, en mettant l'accent sur les imports, le formatage et la définition de paramètres.

Points forts

  • Encourage l'utilisation d'imports en haut du fichier
  • Utilise des underscores pour les grands nombres
  • Impose des paramètres nommés pour les fonctions
  • Interdit le remplissage inutile des __init__.py

Limites

  • Ne couvre pas les conventions de nommage (PEP8)
  • Peut être trop restrictif pour certains projets
  • Ne traite pas des annotations de type
Quand l'utiliser

Utilisez ce skill lorsque vous créez ou modifiez du code Python et souhaitez suivre des conventions de style strictes et claires.

Quand l'éviter

Évitez ce skill si vous travaillez sur un projet avec son propre guide de style ou si la flexibilité est préférée.

Analyse de sécurité

Sûr
Score qualité85/100

This skill contains only Python style and code organization guidelines. There are no executable commands, destructive operations, or any instructions that could pose a security risk.

Aucun point d'attention détecté

Comment cette analyse est faite

Exemples

Create a new Python module
Create a new Python file called utils.py. Ensure imports are at the top, use keyword-only arguments for any functions with more than one parameter, and do not add anything to __init__.py.
Refactor existing Python code
Refactor the following Python code to follow best practices: move all imports to the top, enforce keyword arguments in functions with multiple parameters, and use underscores for large numbers where applicable.
Add a function with parameters
Add a function `calculate_tax(*, income: float, rate: float) -> float` that computes tax. Make sure all parameters are keyword-only and required.

name: python description: Guidelines when creating, reading, updating, or deleting Python code

Python Guidelines

Instructions

imports

Imports should ALWAYS be at the top of the file. NEVER have local imports unless it is 100% necessary.

formatting

For big numbers, use _ to make numbers more clear BAD: foo = 1000 GOOD: foo = 1_000

init.py files

Do not add anything inside of __init__.py files unless it is absolutely necessary or you are explicitly asked to. This includes adding __all__; NEVER add that.

function parameters

Functions with more than 1 parameter should ALWAYS use * to enforce keyword arguments. BAD: def foo(a, b, c): ... GOOD: def foo(*, a, b, c): ... Functions should always use required parameters unless making a parameter optional is absolutely necessary. Functions should not set defaults for parameters unless it is an EXTREMELY sane default.

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-guidelines-mmh8qr3k/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-guidelines-mmh8qr3k' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/python-guidelines-mmh8qr3k/download' --output '.skill-downloads/python-guidelines-mmh8qr3k/SKILL.md.part' && mv '.skill-downloads/python-guidelines-mmh8qr3k/SKILL.md.part' '.skill-downloads/python-guidelines-mmh8qr3k/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-guidelines-mmh8qr3k/SKILL.md' && test -s '.skill-downloads/python-guidelines-mmh8qr3k/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/python' && cp -R '.skill-downloads/python-guidelines-mmh8qr3k' '.claude/skills/python'

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

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

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-guidelines-mmh8qr3k'

openskills read 'python-guidelines-mmh8qr3k'

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-guidelines-mmh8qr3k/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