Synthèse automatique
Cette skill fournit un ensemble compact de règles de formatage de code couvrant les objectifs de lisibilité, l'intégration éditeur et la gestion du code hérité.
Points forts
- Énonce des objectifs clairs et concrets : lisibilité, revue de code, réduction des diffs inutiles
- Donne des consignes pratiques d'intégration éditeur (format à la sauvegarde, .editorconfig, fins de ligne Unix)
- Propose une stratégie incrémentale réaliste pour le code hérité au lieu d'un reformatage massif
- Reste court et facile à parcourir, donc peu coûteux en contexte
Limites
- Ne contient aucune configuration prête à l'emploi ni commande pour black ou ruff, seulement des principes
- Cible implicitement Python sans le formaliser, ce qui limite la portée pour d'autres langages
- Document volontairement artificiel servant de fixture de test pour compter les tokens
À utiliser lorsqu'il faut cadrer rapidement les conventions de formatage d'une équipe et l'intégration des formateurs dans l'éditeur.
À éviter si vous cherchez des fichiers de configuration complets ou des règles spécifiques à un langage autre que Python.
Analyse de sécurité
SûrThe skill contains only static code-formatting guidance. It declares no tools, executes no commands, accesses no network or files, and includes no destructive, exfiltration, or obfuscated instructions.
Aucun point d'attention détecté
Comment cette analyse est faiteExemples
Write an .editorconfig for our Python repo and tell me how to enable format-on-save so everyone uses the same black and ruff settings.Our repo has lots of code that doesn't match black's style. Give me a plan to converge without one massive reformatting commit.Draft a short formatting guideline section for our team handbook: line length, imports, and what humans vs automated tools should handle.name: small-skill description: Small skill with basic content for token testing license: MIT
Small Skill: Code Formatting Guidelines
This skill describes a compact but realistic set of code formatting guidelines. It is used in tests that measure token counts for skill metadata versus full content. The text is intentionally longer than the template skill so that the savings from progressive disclosure are obvious when only the lightweight metadata is injected into the system prompt.
Goals of Consistent Formatting
- Make code bases readable by any team member.
- Reduce cognitive load when switching between files.
- Minimize unnecessary diffs during code review.
- Allow automated tools such as
blackandruffto do most of the work.
When formatting is predictable, reviewers can focus on the substance of a change instead of spending time commenting on indentation, line length, or import ordering. A good rule of thumb is that humans should spend their attention on naming, structure, and correctness, while automated tools enforce the small mechanical rules.
Editor Integration
Most developers experience formatting rules through their editor or IDE. To keep friction low:
- Enable "format on save" for the primary language server.
- Configure the same line length in both the formatter and linter.
- Make sure the editor uses UTF‑8 and Unix line endings by default.
- Share editor configuration files (such as
.editorconfig) in the repository.
The important part is that everyone on the team runs the same tools with
the same configuration. If a project uses black, developers should not
disable it locally or override its defaults in surprising ways.
Handling Legacy Code
In real projects there is almost always some legacy code that does not match the current formatting rules. A practical approach is:
- Avoid reformatting the entire repository in a single massive commit.
- Instead, reformat files as they are touched for real changes.
- For large refactors, coordinate with the team so that merges remain manageable.
This incremental strategy allows teams to converge toward a consistent style without breaking every open feature branch. The tests in this repository treat this document as a "small" skill that still contains enough natural language to produce a meaningful token count.
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 annexesCe 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.mdDepuis la racine d’un projet de test, enregistrez le fichier sous .skill-downloads/code-formatting-guidelines-mrwakfqg/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/code-formatting-guidelines-mrwakfqg' && curl --fail --show-error --location 'https://skills-guides.com/api/skills/code-formatting-guidelines-mrwakfqg/download' --output '.skill-downloads/code-formatting-guidelines-mrwakfqg/SKILL.md.part' && mv '.skill-downloads/code-formatting-guidelines-mrwakfqg/SKILL.md.part' '.skill-downloads/code-formatting-guidelines-mrwakfqg/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/code-formatting-guidelines-mrwakfqg/SKILL.md' && test -s '.skill-downloads/code-formatting-guidelines-mrwakfqg/SKILL.md' && mkdir -p '.claude/skills' && test ! -e '.claude/skills/small-skill' && cp -R '.skill-downloads/code-formatting-guidelines-mrwakfqg' '.claude/skills/small-skill'Cursor
test -f '.skill-downloads/code-formatting-guidelines-mrwakfqg/SKILL.md' && test -s '.skill-downloads/code-formatting-guidelines-mrwakfqg/SKILL.md' && mkdir -p '.cursor/skills' && test ! -e '.cursor/skills/small-skill' && cp -R '.skill-downloads/code-formatting-guidelines-mrwakfqg' '.cursor/skills/small-skill'Codex
test -f '.skill-downloads/code-formatting-guidelines-mrwakfqg/SKILL.md' && test -s '.skill-downloads/code-formatting-guidelines-mrwakfqg/SKILL.md' && mkdir -p '.agents/skills' && test ! -e '.agents/skills/small-skill' && cp -R '.skill-downloads/code-formatting-guidelines-mrwakfqg' '.agents/skills/small-skill'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’OpenSkillsopenskills install './.skill-downloads/code-formatting-guidelines-mrwakfqg'openskills read 'code-formatting-guidelines-mrwakfqg'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 syncMode 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/code-formatting-guidelines-mrwakfqg/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.
Bonnes pratiques React Hook Form
Developpement
Maîtrisez React Hook Form : évitez les anti-patterns, gérez les abonnements, et traitez correctement reset, dirty state et entrées contrôlées.
Migration Emotion vers Mantine
Developpement
Migrer les styled-components Emotion vers des composants Mantine avec style props et modules CSS. Pour convertir .styled.tsx ou supprimer les imports @emotion.
Détecteur de dérive de périmètre
Developpement
Analyse les diffs git par rapport à une intention pour détecter la dérive de périmètre, fichiers non liés et PR trop larges, puis suggère de garder, diviser ou justifier.