Skill clean-code
✓ VérifiéApplique des normes de codage telles que la responsabilité unique, la clarté de la nomenclature et la gestion de la complexité lors de la génération ou de la modification de code d'implémentation.
- Étoiles GitHub
- 211
- Fichiers
- 2
- Dernier commit
- 24 oct. 2026
- Licence
- MIT
- Outils autorisés
- —
Que fait la skill clean-code ?
Applique des normes de codage telles que la responsabilité unique, la clarté de la nomenclature et la gestion de la complexité lors de la génération ou de la modification de code d'implémentation.
Résumé généré à partir du SKILL.md de la skill.
À propos du skill clean-code
Maintenir une qualité d'implémentation élevée pendant le processus de codage est la fonction principale de ce SKILL. Il est conçu pour les développeurs qui doivent s'assurer que chaque unité de code individuelle respecte des normes strictes de clarté de nommage, de responsabilité unique et de gestion de la complexité. Le SKILL est automatiquement chargé par des agents spécialisés comme code-forge, refactor-safely et bug-fix lorsqu'un utilisateur demande des améliorations de la qualité du code ou des directives de codage spécifiques.
Au lieu de se concentrer sur l'architecture globale ou la sécurité, cet outil régit l'art d'écrire des fonctions et des variables spécifiques. Il s'appuie sur un système de configuration qui lit .lattice/config.yaml pour appliquer des normes personnalisées ou des idiomes spécifiques à un langage pour la gestion des erreurs et les systèmes de types. Le SKILL utilise une checklist d'auto-validation pour surveiller la taille des fonctions, la complexité cyclomatique et le nombre de paramètres, garantissant que le code reste auto-documenté et facile à tester. Il effectue également un scan actif des anti-patterns tels que l'imbrication profonde, les noms cryptiques et les erreurs ignorées afin d'empêcher la dette technique d'entrer dans la base de code.
Ce qu'un agent peut faire avec
- 1Appliquer la responsabilité unique dans les fonctionsDemandez à l'agent de refactoriser une fonction volumineuse qui remplit plusieurs tâches en unités plus petites et ciblées.
- 2Réduire la complexité cyclomatiqueDemandez à l'agent de simplifier la logique conditionnelle complexe au sein d'un bloc de code spécifique.
- 3Améliorer le nommage des variables et des fonctionsDonnez instruction à l'IA de renommer les variables et les fonctions afin que leur intention soit claire sans commentaires supplémentaires.
Rédigé à partir du SKILL.md du skill. Chaque cas d'utilisation est vérifié par rapport à une citation de celui-ci.
Comment installer la skill clean-code
Chaque commande copie le dossier de la skill dans le répertoire des skills du client. Redémarrez le client ou démarrez une nouvelle session pour la charger.Installer la skill clean-code dans Plugin
/plugin marketplace add techygarg/lattice /plugin install lattice@lattice
Installer la skill clean-code dans Claude Code
~/.claude/skills/clean-code/SKILL.md
$ npx degit techygarg/lattice/skills/clean-code ~/.claude/skills/clean-codeInstaller la skill clean-code dans Claude Code (project)
.claude/skills/clean-code/SKILL.md
$ npx degit techygarg/lattice/skills/clean-code .claude/skills/clean-codeInstaller la skill clean-code dans Codex
~/.agents/skills/clean-code/SKILL.md
$ npx degit techygarg/lattice/skills/clean-code ~/.agents/skills/clean-codeInstaller la skill clean-code dans Gemini CLI
~/.gemini/skills/clean-code/SKILL.md
$ npx degit techygarg/lattice/skills/clean-code ~/.gemini/skills/clean-codeInstaller la skill clean-code dans Claude.ai
npx degit techygarg/lattice/skills/clean-code clean-code && zip -r clean-code.zip clean-code # claude.ai → Customize → Skills → + → Create skill → Upload a skill → clean-code.zip
Vérifications automatisées
Exécuté le 15 nov. 2026Rapport complet →A réussi nos vérifications automatiques. Ce n'est pas un audit de sécurité : lisez les scripts avant de laisser un agent les exécuter. Fonctionnement des vérifications
- Dépôt source lié et accessibletechygarg/lattice/skills/clean-code is public and reachablegithub.com/techygarg/lattice/tree/HEAD/skills/clean-code ↗Réussi
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit 2026-10-24github.com/techygarg/lattice/commits ↗Réussi
- Aucun téléchargement-exécution ni vol d'identifiants dans les scriptsNo scripts in the skill folderRéussi
- Aucune instruction cachée dans SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/techygarg/lattice/blob/HEAD/skills/clean-code/SKI ↗Réussi
- Les outils préautorisés sont limitésNo pre-approved tools; the agent asks before using onegithub.com/techygarg/lattice/blob/HEAD/skills/clean-code/SKI ↗Réussi
- SKILL.md respecte le format Agent SkillsValid name and description; says when to use it; 65 linesgithub.com/techygarg/lattice/blob/HEAD/skills/clean-code/SKI ↗Réussi
SKILL.md
Voir sur GitHubClean Code
Config Resolution
Projects can customize this skill's standards. Resolution order:
- Read
.lattice/config.yamlin the repo root. - If found, check
paths.clean_codefor a custom document path. - If a custom document exists at that path, read it and check its YAML frontmatter for
mode:mode: override: the custom document has full precedence. Use it instead of the embedded defaults. It must be comprehensive -- treat it as the sole reference.mode: overlay(or no mode field): read the embedded./references/defaults.mdfirst, then apply the custom document's sections on top. A custom section replaces the matching default section (matched by exact heading); new sections append after the defaults.
- If a custom path is configured but no document exists at it → tell the user which configured path is missing, then fall back to
./references/defaults.md. - If there is no config file or no
paths.clean_codekey, read./references/defaults.md. - Language adaptation: if
paths.language_idiomsis set in the config and the document exists, read it and adapt the defaults using these sections:- "Error Handling" → adapt §8 (Error Handling) patterns to the language's idioms. Language idioms take precedence over the pseudocode defaults.
- "Type System & Object Model" → adapt §1 (Single Responsibility) cohesion guidance to the language's constructs (e.g., struct vs class).
- "Naming Conventions" → adapt §4 (Meaningful Naming) patterns to the language's conventions.
- "Parameter & Function Design" → adapt §2 (Small, Focused Functions) and §5 (Parameter Design) to the language's capabilities.
- "Dependency Management" → adapt §9 (Test-Friendly Code) dependency-injection patterns to the language's idioms.
Self-Validation Checklist
STOP after generating each component. Verify ALL checks. Fix every failed check before presenting. Judgment calls → present options (see Ambiguity Signals).
- SINGLE RESPONSIBILITY: Can you describe each function without "and"? If not → extract a separate function.
- SIZE: Is each function under the size threshold from the loaded doc (~20 lines default)? If not → extract a sub-operation into its own named function.
- COMPLEXITY: Is cyclomatic complexity under the threshold from the loaded doc (~10 default)? If not → flatten with a guard clause or extract a branch.
- ABSTRACTION LEVEL: Does each function operate at one level of abstraction? If high-level logic mixes with low-level detail → extract the detail.
- NAMING: Does each function/variable name reveal intent without needing surrounding context? If not → rename to be self-documenting.
- PARAMETERS: Is the parameter count under the threshold from the loaded doc (4 default)? If not → group parameters into an object.
- PRIMITIVE OBSESSION: Would a string/number/boolean be clearer as a named type? If so → introduce a parameter object or typed wrapper.
- ERROR HANDLING: Does every fail-able operation have explicit handling with an actionable message? Is it handled at the right level?
Project-specific checks: if the loaded doc (from Config Resolution) contains a Validation Checklist section (§10 from the clean-code-refiner template), apply those checks as additional project-specific validation after the checklist above.
All checks pass → state "Passes clean-code. [next step]."
Active Anti-Pattern Scan
After the checklist, scan for each of these. Any box you can check → fix before presenting.
- God Function: a function exceeds ~30 lines doing multiple things; describing it requires "and" → extract focused functions.
- Deep Nesting: three or more levels of indentation → flatten with early returns / guard clauses.
- Cryptic Naming: variables like
d,tmp2,processData→ rename to reveal intent. - Long Parameter Lists: five or more parameters → group into an object or split the function.
- Premature Abstraction: a utility extracted from only two similar blocks → inline it until the Rule of Three (third instance with the same reason to change).
- Swallowed Errors: empty catch blocks, generic "something went wrong" messages, silent null returns → handle explicitly.
- Comments as Deodorant: a comment explains convoluted code instead of the code being fixed → rename to self-document; keep only "why" comments, remove "what" comments.
- Hidden Side Effects: a function named
getXalso writes a cache or sends notifications → rename or separate the concern. - Dead Code: commented-out blocks, unused imports, unreachable branches → delete them (version control preserves history).
- Untestable Logic: side effects tangled with business logic; unit testing requires mocking I/O → push side effects to the boundary, extract pure functions, inject dependencies.
Ambiguity Signals
Multiple valid outcomes exist. Present the options rather than silently choosing. If framework:collaborative-judgment is loaded, use its presentation format. See ./references/defaults.md for resolution guidance on each signal below.
- Single Responsibility: two tightly-coupled sequential operations may be one responsibility (a pipeline), not two. The "and" test catches true violations AND false positives.
- Function Size: near-threshold size (20–30 lines) with one clear purpose -- extraction may create five unclear smaller functions. Present the tradeoff.
- DRY vs Premature Abstraction: two identical blocks may serve different purposes and diverge independently. Until a third instance with the same reason to change appears, this is genuinely ambiguous.
- Error Handling Strategy: exception vs Result type vs error codes depends on language idiom and team convention, not on universal rules.
Fichiers de cette skill
2Questions sur la skill clean-code
Comment installer la skill clean-code dans Claude Code ?
Exécutez npx degit techygarg/lattice/skills/clean-code ~/.claude/skills/clean-code. Claude Code charge les skills depuis ~/.claude/skills (tous les projets) ou .claude/skills (un seul projet) et utilise une skill lorsque sa description correspond à la tâche.
Quels clients peuvent utiliser la skill clean-code ?
Tout client qui lit le format Agent Skills : Claude Code, Codex, Gemini CLI et claude.ai (envoi sous forme de ZIP). Les scripts de la skill ne s'exécutent que si le client autorise l'exécution de code.
Quels sont les seuils par défaut pour la taille et la complexité des fonctions ?
Par défaut, les fonctions doivent comporter moins de 20 lignes environ et maintenir une complexité cyclomatique inférieure à 10 environ.
Comment un projet peut-il personnaliser les normes de clean code ?
Les projets peuvent personnaliser les normes en définissant un chemin de document personnalisé dans .lattice/config.yaml, en utilisant soit le mode 'override' pour une priorité totale, soit le mode 'overlay' pour compléter les paramètres par défaut.