Communitygithub.com

imswarnil/Personal-Website-Jekyll-Theme

Décide de l'image de couverture idéale pour chaque entrée du thème — article, projet, film, épisode, cours, podcast, lettre d'information, voyage, équipement — avec instructions pour une photographie, une image générée, ou laisser le dessin de secours par défaut.

Qu'est-ce que Personal-Website-Jekyll-Theme ?

Cette compétence spécialisée pour le thème Jekyll de site personnel fournit des directives précises sur la manière de choisir ou de générer l'image de couverture (`image:`) pour chaque type de contenu. Elle repose sur un principe fondamental : la couverture ne doit jamais contenir de texte, car le titre est déjà affiché en police réelle sous la carte. Chaque collection (`posts`, `portfolio`, `videos`, etc.) a ses propres règles : par exemple, les articles de blog conservent l'image par défaut sauf si une photo pertinente existe, les projets de portfolio doivent toujours utiliser une capture d'écran réelle, et les vidéos ne doivent pas avoir d'image de couverture personnalisée (la vignette YouTube est prioritaire). Pour les collections comme les voyages, une photographie de paysage est fortement recommandée, tandis que pour les newsletters et les podcasts, le dessin par défaut est préférable pour ne pas tromper le visiteur sur la nature du contenu. La compétence inclut également un modèle de prompt pour générer des images via IA (photographie, pas d'illustration conceptuelle) et des instructions techniques pour ajouter de nouvelles collections avec leurs marques visuelles.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imswarnil/Personal-Website-Jekyll-Theme/tree/HEAD/.claude/skills/collection-art

Demander à votre IA préférée

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

Documentation

Ce que doit être une couverture, par collection

Chaque entrée de ce thème peut avoir une image:. Si ce n'est pas le cas, une image est dessinée à partir de sa collection — la couleur, le motif et la marque de la collection. Ce dessin de secours est une vraie réponse, pas un espace réservé, et pour plusieurs collections, c'est la bonne réponse. La première question n'est donc pas « quelle image » mais « devrait-il y avoir une image du tout ? ».

La règle qui les gouverne toutes

Une couverture ne porte pas de mots. Le titre est déjà sous la carte, en police réelle qui s'adapte, se reformate et peut être sélectionné. Le placer à nouveau dans l'image signifie qu'il est défini deux fois, à une taille que personne n'a choisie, et coupé dès que la carte est plus étroite que l'illustration. Si une couverture semble nécessiter une légende, la légende doit être dans description:.

Une couverture est en 16:10 dans une carte, 2:3 comme affiche de série, 9:16 comme reel, et 1200×675 comme carte sociale. Tout ce qui est publié doit survivre à tous ces recadrages, ce qui signifie : sujet à peu près centré, rien d'important dans le sixième extérieur.

Par collection

posts — laissez le dessin par défaut, sauf si vous avez une photographie qui parle de l'article. Une image générique d'ordinateur portable est pire que la couverture dessinée, car celle-ci dit au moins honnêtement « ceci est un article ». Bonnes exceptions : une photo que vous avez prise de la chose dont vous parlez, une capture d'écran de l'artefact réel, un diagramme que vous avez réalisé.

portfolio — une vraie capture d'écran, toujours. C'est la seule collection où une couverture générique est un échec : tout l'intérêt d'une entrée de projet est de montrer ce que vous avez créé. Utilisez screenshots: pour le carrousel et laissez image: être la meilleure d'entre elles. Prenez l'interface à une largeur réelle avec du contenu réel — jamais de lorem, jamais un état vide.

videos — n'en définissez pas. La vignette YouTube est récupérée depuis video_id:, et c'est le cadre que vous avez déjà choisi dans l'interface d'upload. Définir une image: différente signifie que la carte et la vidéo ne sont pas d'accord.

webseries — un poster: en 2:3, et cela vaut la peine de le faire correctement : une image fixe de la série, étalonnée, avec de l'espace en bas où le titre et les informations reposent sur le voile. Portrait, car c'est la forme d'une carte de titre depuis le temps du vidéo-club.

episodes — l'image fixe de cet épisode, ou rien. Si video_id: est défini, elle vient de YouTube comme une vidéo.

courses — laissez le dessin par défaut, ou utilisez un cadre de la chose enseignée (le tableau de bord, l'éditeur, l'instrument). Une couverture avec une personne souriante devant un ordinateur portable est un signe certain de photo générique.

lessons — rien. Une leçon vit à l'intérieur d'un cours ; l'illustration du cours est l'identité, et une image par leçon ajoute simplement du bruit à la liste du programme.

podcast — laissez le dessin par défaut. L'illustration propre du podcast appartient à la collection (image: dans _config.yml), pas par épisode. Une photo d'invité ne vaut le coup que lorsque l'invité est l'attraction principale.

newsletter — laissez le dessin par défaut. Un numéro est une lettre ; une image sur le devant est une couverture de magazine, ce qui crée une attente erronée pour le format.

snippets et prompts — n'en définissez jamais. Les deux cartes sont l'illustration : une fenêtre de code et une fenêtre de chat, dessinées à partir du contenu même de l'entrée. Une image se trouverait au-dessus d'une image de la chose qu'elle tente d'illustrer.

travel — une photographie, et la meilleure que vous ayez. C'est l'autre collection où l'image est le contenu. Paysage, prise suffisamment large pour que le recadrage 4:3 de la carte ne coupe pas le sujet. Les mots reposent sur le voile en bas, donc laissez ce tiers sans encombrement.

uses — une photo de produit nette sur fond uni, ou la couverture dessinée. Prenez-la vous-même quand vous le pouvez : un rendu du fabricant à côté de vos propres photographies semble emprunté, car il l'est.

docs — rien. Les lignes portent une icône.

Si vous en générez une

Décrivez-la comme une photographie, pas comme une illustration d'un concept :

Une photographie [large/portrait] de [le sujet réel], [éclairage], prise avec [caractère de l'objectif]. Pas de texte, pas de logos, pas de personnes regardant l'objectif. La composition laisse le tiers inférieur sans encombrement.

Ensuite, vérifiez-la à 320 px de large — la taille qu'une carte affiche réellement — avant de décider qu'elle fonctionne. La plupart des images générées échouent à cette échelle, et une couverture qui n'est lisible qu'en pleine taille est une couverture qui n'est lisible que dans le brief.

Ajouter une collection

Donnez-lui une marque dans _includes/utility/mark.html et le même dessin dans MARKS dans tools/thumbs.mjs — la couverture en ligne et celle basée sur un fichier doivent correspondre, car une entrée qui obtient plus tard un vrai .svg ne doit pas soudainement ressembler à un site différent. Des formes simples sur une grille de 24 unités : à la taille où une carte les affiche, le détail est du bruit.

Ensuite, npm run thumbs et la collection a son illustration.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés