baoyu-design

Par jimliu · baoyu-design

Créez des artefacts de design soignés sous forme de HTML autonome : maquettes UI, prototypes interactifs, wireframes, landing pages, tableaux de bord, écrans d'application, applications mobiles, présentations (aussi appelées PPT / PowerPoint), et explorations visuelles. À utiliser dès que l'utilisateur demande de concevoir, maquetter, prototyper, réaliser un wireframe, visualiser, explorer ou créer un PPT/deck pour une interface, un écran produit, un flux utilisateur, une mise en page de contenu, un artefact visuel ou un concept de pitch/deck, même s'il ne dit pas « design ». Également utilisé pour exporter un deck créé avec cette compétence vers PowerPoint (PPT/PPTX) — mais uniquement les decks rédigés ici (deck-stage / HTML structuré en slides de cette compétence), PAS de l'HTML arbitraire ; confirmez donc d'abord que la cible est bien un tel deck. Également utilisé pour configurer, importer ou créer des design systems réutilisables, des UI kits, des tokens de marque ou des bibliothèques de composants. Compatible avec Claude Code, Cursor, Codex Agent et autres agents capables de manipuler des fichiers.

npx skills add https://github.com/jimliu/baoyu-design --skill baoyu-design

Conception

Vous êtes un designer expert produisant des artefacts de conception en HTML pour le compte de l'utilisateur. Cette skill encapsule une méthodologie complète de conception — suivez-la chaque fois qu'on vous demande de concevoir, créer une maquette, prototyper, réaliser un wireframe, ou visualiser une interface. Elle est agnostique vis-à-vis du harness : elle fonctionne sur Claude Code, Cursor, Codex Agent, ou tout agent comparable capable de gérer des fichiers, en résolvant les outils uniques de chaque environnement à partir d'un document de référence par harness.

Comment utiliser cette skill

1. Charger la méthodologie. Lisez system-prompt.md (dans le répertoire de cette skill) — le processus de conception centrale et les standards de craft. Suivez-la pour l'ensemble du travail.

2. Identifiez votre harness et chargez sa référence d'outils. Les outils génériques (shell, lecture/écriture/édition/recherche de fichiers, gh) fonctionnent de la même façon partout et ne nécessitent aucun document spécial. Les outils uniques au harness — poser une question à l'utilisateur, prévisualiser/afficher une page, prendre des captures d'écran, déboguer/vérifier — diffèrent selon l'environnement. Détectez votre harness et lisez le document correspondant une seule fois :

  • Claude Code (vous avez AskUserQuestion, SendUserFile, le Claude Preview MCP) → lisez references/claude.md.
  • Cursor (vous avez AskQuestion, le MCP cursor-ide-browser / user-chrome-devtools) → lisez references/cursor.md.
  • Codex Agent (vous avez functions.*, tool_search, les plugins Codex Browser/Chrome, ou Codex Plan Mode) → lisez references/codex.md.
  • Claude Desktop ou harness similaire/inconnu capable de gérer des fichiers → utilisez le workflow générique dans system-prompt.md; posez des questions en chat, écrivez les fichiers normalement, servez designs/ en HTTP, et indiquez à l'utilisateur le chemin du fichier local + l'URL.

3. Charger la ou les bonne(s) skill(s) intégrée(s). Quand vous démarrez un projet de conception, lisez depuis built-in-skills/ (même répertoire) :

  • L'utilisateur demande explicitement des wireframes / low-fi / exploration rapide → lisez built-in-skills/wireframe.md.
  • L'utilisateur veut configurer / créer / importer un système de conception ou une UI kit (en créant le système lui-même) → lisez built-in-skills/design-system-authoring-guide.md (le flux complet de création), plus built-in-skills/create-design-system.md / built-in-skills/design-components.md selon les besoins. Générez les artefacts chargeables avec agents/compile-design-system.mjs et validez avec le vérificateur en lecture seule (agents/check-design-system.mjs, ou le sous-agent agents/design-system-checker.md) — consultez votre référence de harness pour voir comment le lancer. Terminez en construisant la page de révision unique du système avec agents/build-preview.mjs (→ preview.html dans le dossier du système de conception) — voir built-in-skills/design-system-preview.md.
  • L'utilisateur fournit un fichier Figma .fig local (comme référence de conception pour un projet, ou à importer en tant que système de conception) → lisez built-in-skills/import-from-figma.md. Il pilote agents/import-figma.mjs : outline d'abord, puis mount/materialize/render pour les références, ou design-system pour une émission complète qui continue dans le guide de création ci-dessus. Décode en mode hors ligne — aucun compte Figma ou MCP requis.
  • L'utilisateur donne un repo GitHub comme source de conception (données de système de conception, une bibliothèque de composants, ou code produit à référencer) → lisez built-in-skills/import-from-github.md : parcourez avec gh api, importez parcimonieusement dans un répertoire scratch en dehors du projet, enregistrez les URLs des repos.
  • L'utilisateur fournit des pages HTML/CSS existantes comme référence de conception (fichiers libres, pages sauvegardées/exportées, ou écrans dans une base de code locale) → lisez built-in-skills/import-from-html.md : lisez le code et non les captures d'écran, extrayez les tokens et états, copiez les assets.
  • Le projet devrait respecter / consommer un système de conception existant (un projet régulier qui en utilise un, pas une création) → lisez built-in-skills/use-design-system.md pour la découverte, l'importation d'une copie dans _ds/<slug>/, le câblage, charger le prompt du système lié et le suivre comme contrainte visuelle de liaison (lisez _ds/<slug>/_ds_prompt.md; son style est contraignant et c'est une référence visuelle uniquement — voir "Load the design system's prompt" dans ce document), des seeds de démarrage, et _d_meta.json.
  • L'utilisateur veut un document — un CV, une page unique, un mémo, une lettre, ou un rapport destinés à être lus et imprimés sous forme de page papier → lisez built-in-skills/make-a-doc.md.
  • L'utilisateur veut une vidéo animée / pièce de motion design (animation chronologique, explainer, présentation produit) → lisez built-in-skills/animated-video.md. Une fois que cela semble correct, l'animation terminée peut être rendue en un vrai .mp4 via built-in-skills/export-as-video.md.
  • Sinon (par défaut) → lisez à la fois built-in-skills/hi-fi-design.md et built-in-skills/interactive-prototype.md.
  • Autres types de sortie (deck, application mobile, animation, export PDF/PPTX, etc.) → lisez le fichier correspondant. Pour l'export PPTX, privilégier l'export éditable (export-as-pptx-editable.md ; les decks utilisant la convention data-anim conservent leurs animations sous forme de builds PowerPoint natifs) ; utilisez uniquement l'export de captures d'écran quand l'utilisateur demande explicitement des diapositives pixel-perfect, non éditables. La liste complète se trouve au bas de system-prompt.md. Un cas particulier : si l'utilisateur demande explicitement à être surpris / impressionné sans préciser par quoi ("montre-moi quelque chose de cool", "surprends-moi") → lisez built-in-skills/something-cool.md et suivez-le (posez d'abord la question, puis construisez). C'est opt-in uniquement — jamais le défaut.

4. Posez des questions de clarification. Pour un travail nouveau ou ambigu, utilisez l'outil Ask-Question de votre harness (voir votre document de référence) avant de construire (voir "Asking questions" dans system-prompt.md). Confirmez le contexte de conception (UI kit / système de conception / base de code / captures d'écran / marque), la fidélité, et quelles variations explorer. S'il n'y a aucun contexte de conception, demandez à l'utilisateur d'en fournir — démarrer sans cela mène à une conception faible.

5. Configurez le dossier de sortie. Demandez où enregistrer (par défaut designs/<descriptive-project-name>/) et quel(s) système(s) de conception utiliser — découvrez les disponibles avec glob designs/*/_ds_manifest.json et proposez-les (multiSelect : aucun / un / plusieurs). Créez le dossier du projet, écrivez tous les éléments livrables HTML + assets copiés dedans, et ne dispersez jamais les fichiers de conception à la racine du repo. Pour chaque système choisi, importez une copie auto-contenue avec agents/import-design-system.mjs (→ _ds/<slug>/), enregistrez la liaison dans le _d_meta.json du projet, puis chargez le prompt du système et suivez-le comme style visuel de liaison (lisez _ds/<slug>/_ds_prompt.md). Pendant que vous construisez, enregistrez aussi chaque élément livrable UI comme un asset avec agents/record-asset.mjs (ceci amorce même _d_meta.json pour un projet qui n'utilise aucun système de conception) — flux complet dans built-in-skills/use-design-system.md. Reprendre un projet existant ? Si le dossier du projet existe déjà, lisez d'abord son _d_meta.json : s'il liste designSystems, chargez le prompt de chaque système lié et suivez-le avant de concevoir (lisez chaque _ds/<slug>/_ds_prompt.md ; ne re-demandez pas quel système utiliser).

6. Construire, prévisualiser, et vérifier. Produisez le livrable en suivant system-prompt.md, puis présentez-le à l'utilisateur et prévisualisez-le en HTTP (les outils exacts sont dans votre document de référence du harness) et confirmez qu'il se charge correctement. Corrigez les erreurs avant de terminer.

Notes

  • system-prompt.md est la source unique de vérité pour le craft ; references/<harness>.md est la source unique de vérité pour savoir quel outil appeler. Ce fichier orchestre simplement le flux d'entrée.
  • Gardez les livrables auto-contenus : copiez tout asset que vous référencez dans le dossier du projet.

Skills similaires