Communitygithub.com

argus

Compétence de conception. Concevoir, construire, restyler, peaufiner ou examiner des sites web et des écrans d'applications mobiles dans n'importe quel framework — pages d'atterrissage, tableaux de bord, écrans d'application, composants, formulaires, système de design. Utilisez-la pour toute demande qui crée ou modifie ce qu'une personne regarde, y compris "construis une page pour X", "ajoute un écran de paramètres", "rends ça plus beau" ou "ça fait générique".

Qu'est-ce que argus ?

Argus est une compétence de conception destinée aux agents d'IA (comme Claude Code, Cursor, Codex) qui doivent créer ou modifier des interfaces utilisateur. Elle comprend que les agents ne peuvent pas voir ce qu'ils produisent et propose donc un processus itératif : construire, regarder le résultat rendu, corriger, et regarder à nouveau. Elle évite les clichés de design en demandant des entrées externes (projet existant, instructions de l'utilisateur) et en favorisant la génération d'alternatives brutes. La compétence fournit un cadre complet pour différentes tâches (ajustement mineur, nouvelle page, audit, redesign) en définissant précisément comment lire les fichiers de référence, poser les bonnes questions, puis suivre une boucle de vérification (construction, rendu, vérification des erreurs, test manuel, correction). Argus s'intègre dans tout projet via des fichiers de références (DESIGN.md, craft.md, laws.md…) et des scripts d'aide. Elle garantit l'accessibilité (contraste, focus clavier, taille minimale des contrôles) et insiste sur un contenu honnête (pas de lorem ipsum, pas de preuves inventées).

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Hamza-Masuadi/argus-skill/tree/HEAD/skills/argus

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait argus ?

Vous connaissez les règles de la conception. Quatre autres choses tournent mal, et cette compétence répond à chacune :

  1. Vous ne pouvez pas voir ce que vous faites. Alors construisez, regardez le résultat rendu, corrigez, et regardez à nouveau.
  2. Votre première idée est celle de tout le monde. Alors prenez des apports extérieurs : ce qui existe, ce que dit l'utilisateur, ce qu'il vous montre.
  3. Vous jugez mieux que vous ne générez. Alors pour un nouveau travail, faites des alternatives grossières et choisissez en regardant.
  4. Vous dérivez vers le médium et le fin. Alors les nouvelles pages obtiennent une idée, un grand geste, et un argument complet.

1. Regarder ce qui existe

Avant toute chose, trouvez et énoncez en une ligne :

  • Plateforme : web, ou application mobile (iOS, Android, les deux). Lisez le projet ; ne présumez jamais.
  • Surface : Persuader (marketing, page d'atterrissage, vitrine), Opérer (tableau de bord, outil, administration, écran d'application) ou Lire (documentation, articles).
  • Système existant : DESIGN.md, fichiers de thème ou de tokens, composants partagés, deux ou trois écrans finalisés.
  • Ce que l'utilisateur a fourni : captures d'écran, liens, logos, couleurs de marque, polices, photographies.

Implémentez avec le framework et les conventions que le projet utilise déjà.

2. Prendre la seule route qui convient

Utilisez la première ligne qui correspond. Lisez uniquement les fichiers qu'elle nomme.

La tâcheFaireLire
Une retouche : un composant, une correction d'espacement ou de couleurFaire la modification et la regarder. Pas de questions, rapport en une ligneRien, ou la partie de craft.md qu'elle touche
Une commande nommée (polish, audit, typeset, colorize, animate, simplify, variants)Suivre la commandereferences/commands/<nom>.md et ce qu'elle nomme
"Examine ceci" ou "critique ceci"Rapporter, ne rien modifierreview.md, laws.md, verify.md
"Rends ça plus beau", "ça fait générique", sur quelque chose qui existeTrouver ce qui ne va pas, puis corriger dans le style existantextend.md section 3, puis commands/polish.md ; pour une faiblesse claire, la commande correspondante
Nouvel écran ou composant dans un projet qui a déjà un styleÉtendre. Pas de travail directionnel, pas de questionsextend.md ; plus product.md pour les surfaces Opérer, mobile.md pour le natif
Nouvelle surface Opérer sans rien sur quoi s'appuyerDemander si le brief est ouvert, puis construireask.md, product.md, craft.md ; mobile.md si natif
Nouvelle surface Persuader ou Lire sans rien sur quoi s'appuyerDemander si le brief est ouvert, puis le flux completask.md, create.md (qui inclut structures.md et ingredients.md), web.md ou mobile.md ; photos.md si les images vendent ou si des photos ont été fournies
Une refonte explicitement demandée par l'utilisateurTraiter comme un nouveau travail, en conservant le contenu et le comportementLa ligne de nouveau travail correspondante, plus extend.md section 1 pour inventorier ce qui doit survivre

Chaque route qui construit quelque chose se termine par la boucle ci-dessous, avec slips.md et verify.md. Les retouches n'ont besoin que d'un regard.

Modifier l'identité d'un produit existant nécessite une demande explicite. Sans cela, "fais-le ressortir" signifie un meilleur travail dans le style actuel.

3. Demander (nouveau travail seulement)

Lorsque le brief laisse ouvert pour qui c'est, comment cela devrait se sentir, ou ce que l'utilisateur a à montrer, demandez avant de concevoir : un tour, au maximum quatre questions sur le produit, chacune pouvant être ignorée, aucune sur les polices ou les couleurs. Pour une nouvelle page, demandez aussi autour de quoi le premier écran devrait être construit (trois approches que vous proposez pour ce sujet) et combien de directions ils veulent voir côte à côte (1, 3 ou 5 ; 3 recommandé). ask.md les contient. Ignorez les questions que le brief ou DESIGN.md répond déjà.

Si personne n'est là pour répondre, énoncez chaque hypothèse et continuez. N'attendez jamais dans une boucle.

4. La boucle

  1. Construire la première version réelle.
  2. Regarder. Rendez-la et capturez-la à 320, 390 et 1440 de large (pour le natif, sur un simulateur ou appareil de taille téléphone). Avant de relire le code, notez ce qui est visible.
  3. Vérifier par rapport à slips.md. Exécutez les scripts qui s'appliquent (voir verify.md).
  4. L'utiliser. Appuyez sur le bouton principal, remplissez le formulaire, naviguez au tab, trouvez la navigation en largeur téléphone.
  5. Corriger ce que vous avez trouvé et regardez à nouveau. Deux tours, puis rapportez ce qui reste.

Si rien ne peut être rendu, dites-le, vérifiez la source à la place, et ne considérez pas le travail comme vérifié. Pour un travail substantiel (une page ou un écran entier) où des sous-agents existent, remettez les captures d'écran à un nouveau relecteur qui n'a pas vu votre raisonnement ; ses corrections comptent comme l'un des deux tours.

Règles qui s'appliquent toujours

  • Qui a le dernier mot : une instruction explicite de l'utilisateur ; puis le système existant ; puis les réponses et références de l'utilisateur ; puis la direction que vous avez écrite ; puis les nombres et listes de cette compétence. Les minimums d'accessibilité ne sont pas remplacés par le goût, le vôtre ou celui de cette compétence. Quelque chose que l'utilisateur a demandé n'est jamais signalé comme un défaut.
  • Contenu honnête. Pas de lorem ipsum, et pas de preuves inventées : témoignages, clients, logos, évaluations, chiffres d'utilisation. Les faits dont une page a besoin (un prix, des conditions d'essai) peuvent être des substituts plausibles, marqués dans un commentaire de code et listés dans le rapport. Les exemples de données dans une démo, un catalogue ou un tableau de bord sont les bienvenus quand ils sont spécifiques, et sont étiquetés comme exemple une fois à l'écran.
  • Le restylage ne change jamais le comportement. Conservez les noms de champs, ids, liens, gestionnaires, actions de formulaire, hooks de test et attributs d'accessibilité.
  • Construisez les états qui peuvent arriver, et tous ceux-là. Pressé et désactivé toujours ; survol et focus clavier partout où il y a un pointeur ou un clavier. Chargement, vide et erreur partout où quelque chose de réel se charge, peut être vide ou peut échouer. Ne construisez jamais un appel réseau juste pour avoir un état de chargement.
  • Minimums d'accessibilité : contraste du texte 4,5:1 ; focus clavier visible ; contrôles d'au moins 24px, et 44pt / 48dp sur écrans tactiles ; un chemin avec mouvement réduit ; rien de perdu lorsque le texte est agrandi. craft.md contient les nombres et laws.md la norme exacte.
  • Vérifié signifie regardé.

Rapport

Trouvé :     plateforme, surface, système existant, ce que l'utilisateur a fourni
Direction :  une phrase (nouveau travail), ou ce qui a été réutilisé et ce qui a été ajouté (extension)
Regardé :    ce qui a été rendu, à quelles largeurs, ce qui a été utilisé manuellement
Corrigé :    ce que la boucle a attrapé
Supposé :    faits de substitution et exemples de données, par type, ou "aucun"
Ouvert :     ce qui n'est pas fait ou pas vérifié, et tout ce qu'un guide dit de signaler

Limitez-vous à ces lignes. Une retouche a droit à une ligne.

Fichiers

FichierContient
ask.mdLe tour de questions
create.mdNouveau travail Persuader et Lire : l'idée, le grand geste, les alternatives grossières, la direction
structures.mdStructures de page entre lesquelles choisir, afin que les alternatives diffèrent par la forme et pas seulement par la couleur
ingredients.mdLes rôles de tokens que chaque direction remplit, et les options pour la couleur, la typographie, la forme et l'espace
extend.mdTravailler dans un style existant
product.mdSurfaces Opérer : tableaux de bord, outils, écrans d'application
photos.mdPages dirigées par des photographies
web.md, mobile.mdCe qui va où sur une page web ou un écran de téléphone
slips.mdErreurs réellement commises, par surface. Vérifié à chaque regard
verify.mdComment capturer, vérifier et examiner ; les scripts d'aide
craft.mdChaque nombre : typographie, couleur, espace, mouvement, cibles
laws.mdCe que les lois de l'UX justifient et ne justifient pas ; mythes
tells.mdDéfauts courants de conception générée
review.md, design-md.mdFormat de critique ; enregistrement des décisions

Tout se trouve dans references/.

Chaque chemin dans cette compétence (references/..., scripts/..., assets/...) est relatif au dossier qui contient ce fichier, pas au projet de l'utilisateur. Dans Claude Code, ce dossier est ${CLAUDE_SKILL_DIR}. Lors de l'exécution d'un script, utilisez son chemin complet, par exemple node "<dossier de cette compétence>/scripts/lint.js" <cible>.

Skills associés