--- name: writing-miniature-tutorials description: Use when the user asks to create or update a miniature or figurine painting tutorial in this wiki, including paint recipes, project color schemes, basing, or an illustration of the expected result. --- # Writing Miniature Painting Tutorials Créer une page Markdown exploitable avec le matériel réel de l'utilisateur. Traiter `src/content/docs/figurines/painting-set.md` comme l'unique source d'inventaire. ## Workflow 1. Se placer à la racine qui contient `src/content/docs/figurines/painting-set.md`. Arrêter si ce fichier manque. 2. Obtenir le nom du projet et celui de la figurine. Ce sont les seules informations bloquantes. Déduire le style, la difficulté et le socle de la demande; annoncer les hypothèses utiles. 3. Lire le painting set au moment de la demande. Relever chaque couple référence/nom exact sans recopier cette liste dans le skill. 4. Lire les pages `.md` du projet dans `src/content/docs/figurines//`, puis choisir le degré de cohérence adapté. 5. Concevoir la palette avec les règles de théorie des couleurs ci-dessous. 6. Créer `src/content/docs/figurines//.md`. Employer des minuscules ASCII et des tirets pour le projet et le fichier. 7. Valider la page, corriger les erreurs, puis lancer le build. ## Théorie des couleurs - Définir une couleur dominante, une couleur secondaire et une ou deux couleurs d'accent. - Construire d'abord le contraste de valeur : les ombres, tons moyens et éclaircissements doivent rester distincts à distance de jeu. - Utiliser la température et la saturation pour séparer les zones proches. Réserver les couleurs les plus saturées aux points focaux. - Choisir une harmonie adaptée au sujet : analogue pour l'unité, complémentaire pour un accent fort, ou chaude/froide pour séparer les matériaux. Ne pas imposer une formule si le schéma demandé fonctionne autrement. - Vérifier les mélanges réels avec le painting set. Éviter les mélanges complémentaires excessifs qui produisent une teinte terne, sauf pour neutraliser volontairement une ombre. - Expliquer brièvement les choix utiles dans le tutoriel par leur effet visuel, sans ajouter un cours théorique séparé. ## Cohérence du projet Donner priorité au schéma demandé par l'utilisateur, puis choisir l'un de ces modes d'après les pages existantes : - **Schéma commun :** conserver la même palette et introduire de légères variations de mélanges, d'usure ou d'accents. - **Palettes variées :** autoriser des schémas différents tout en conservant quelques marqueurs communs, comme les métaux, les cuirs, le traitement des ombres ou les socles. - **Thème commun :** laisser chaque figurine avoir son propre schéma tout en partageant une ambiance, une température, un niveau de saturation ou une histoire visuelle. Ne pas figer un projet à partir d'une seule page. Conserver seulement les marqueurs pertinents pour la nouvelle figurine et laisser varier le reste. En l'absence d'indication claire, adopter le mode le moins contraignant compatible avec les tutoriels existants. ## Produits et mélanges - Utiliser exclusivement les peintures, encres, washes, pigments, médiums, vernis et produits de soclage présents dans le painting set. - Autoriser l'eau et les outils usuels comme le pinceau ou la palette; ne pas les traiter comme des produits de l'inventaire. - Écrire chaque produit, à chaque occurrence, sous la forme `**72.031 Camouflage Green**`. Ne jamais abréger le nom ni omettre la référence. - Créer une teinte absente uniquement par un mélange de produits disponibles. Dire clairement lorsqu'aucun mélange satisfaisant n'est possible. - Détailler chaque mélange avec des proportions en parts, une ligne par composant. Préciser la dilution, le nombre de couches et le séchage lorsqu'ils influencent le résultat. Format d'un mélange : ```markdown **Mélange (2:1)** - 2 parts de **72.031 Camouflage Green** - 1 part de **72.029 Sick Green** Diluer avec 1 part d'eau et appliquer deux couches fines, en laissant sécher chaque couche. ``` ## Format de la page Commencer par ce frontmatter, avec des valeurs non vides entre guillemets doubles : ```markdown --- title: "Nom de la figurine" description: "Résumé du schéma de peinture et du résultat recherché." tags: [leasure, painting, figurines, tuto] --- ``` Ne pas ajouter de titre Markdown de niveau 1 : Starlight affiche déjà le `title`. Placer ensuite ce résumé avant le premier chapitre : ```markdown - **Style recherché :** ... - **Couleurs dominantes :** ... - **Couleurs d'accent :** ... - **Niveau de difficulté :** ... - **Temps estimé :** ... ``` Utiliser exactement ces titres de niveau 2, dans cet ordre : ```markdown ## 1. Bases ## 2. Ombrage ## 3. Éclaircissements ## 4. Finitions ## 5. Socle ``` Dans chaque chapitre : - regrouper les étapes par couleur avec des titres de niveau 3; - traiter les grandes zones avant les détails; - éviter de revenir plusieurs fois sur une même zone; - ajouter au bon endroit les conseils de geste, charge du pinceau, dilution, séchage et correction des erreurs; - couvrir toutes les zones visibles de la figurine et terminer les finitions avant le socle. ## Compatibilité Astro et Starlight - Créer une page `.md`, pas `.mdx`. - Employer du Markdown standard. Ne placer aucun `import`, `export`, composant Astro ou composant JSX dans la page. - Fermer le frontmatter avec `---` avant le contenu et conserver les champs `title`, `description` et `tags` du modèle ci-dessus. - Utiliser des chemins relatifs valides pour les liens et les images. Enregistrer les images du tutoriel sous `src/assets/figurines//`. - Ne pas considérer la page comme terminée tant que le validateur Node et `npm run build` n'ont pas réussi. Le build Astro constitue la validation définitive du rendu CMS. ## Illustration finale Générer une illustration seulement si l'utilisateur fournit des photos de référence de la figurine. Sans photo, ne créer ni image ni emplacement vide et signaler l'omission dans la réponse finale. Avec des photos, **REQUIRED SUB-SKILL:** utiliser `imagegen` et : - employer les photos comme références de la sculpture et de l'équipement; - produire une seule image montrant la même figurine en pied, de face et de dos, côte à côte; - reproduire le schéma, les matériaux et le socle décrits dans la page; - utiliser un éclairage neutre, un fond gris clair, sans texte ni filigrane; - convertir la sortie du générateur avec `sharp` en JPEG progressif de qualité 88; - enregistrer l'image dans `src/assets/figurines//-reference.jpg` sans écraser un fichier existant; - ajouter l'image à la fin du chapitre `5. Socle` avec un chemin Markdown relatif. ## Vérification Depuis la racine du dépôt, exécuter : ```bash node .agents/skills/writing-miniature-tutorials/scripts/validate-tutorial.mjs \ src/content/docs/figurines//.md npm run build ``` Avant de terminer, vérifier aussi que tous les mélanges ont des proportions, que la théorie des couleurs soutient le contraste recherché et que le tutoriel reste cohérent avec les autres pages du projet. Corriger la page jusqu'à réussite des deux commandes. Ne créer ni branche ni commit.